{"id":"53ee593f-23bf-4d3d-9bc3-0ea07099cbc2","entityType":"agent","slug":"clawhub-redfox-data-xiaohongshu-rank-tracker","name":"小红书热门账号推荐","canonicalUrl":"https://www.xpersona.co/agent/clawhub-redfox-data-xiaohongshu-rank-tracker","canonicalPath":"/agent/clawhub-redfox-data-xiaohongshu-rank-tracker","generatedAt":"2026-10-11T10:51:27.750Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T07:25:59.093Z","emptyReason":null},"description":"小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Skill: 小红书热门账号推荐 Owner: redfox-data Summary: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Tags: latest:1.0.2 Version history: v1.0.2 | 2026-07-28T05:43:18.511Z | user xiaohongshu-rank-tracker 1.0.2 更新日志 - 移除了 skill-card.md 说明文件，无其他功能或逻辑变更。 - 文档简化和部分描述调整，保持 Skill 主体功能不变。 v1.0.1 | 2026-06-02T09:52:06.655Z | user xiaohongshu-rank-tracker v1.0.1 - Renamed skill: now called \"xiaohongshu-top-account\" to better reflect the function","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s171kp1a76rjevha5b9m61sxv984vncz:xiaohongshu-rank-tracker","sourceUrl":"https://clawhub.ai/redfox-data/xiaohongshu-rank-tracker","homepage":"https://clawhub.ai/redfox-data/skills/xiaohongshu-rank-tracker","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/redfox-data/xiaohongshu-rank-tracker","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/redfox-data/skills/xiaohongshu-rank-tracker","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Skill: 小红书热门账号推荐 Owner: redfox-data Summary: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Tags: latest:1.0.2 Version history: v1.0."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T07:25:59.093Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T07:25:59.093Z","emptyReason":null},"stars":null,"forks":null,"downloads":1124,"packageName":null,"latestVersion":"1.0.2","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T07:25:59.024Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T07:25:59.093Z","lastCrawledAt":"2026-10-11T07:25:59.024Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T07:25:59.024Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.2","createdAt":"2026-07-28T05:43:18.511Z","changelog":"### xiaohongshu-rank-tracker 1.0.2 更新日志 - 移除了 skill-card.md 说明文件，无其他功能或逻辑变更。 - 文档简化和部分描述调整，保持 Skill 主体功能不变。","fileCount":9,"zipByteSize":34876},{"version":"1.0.1","createdAt":"2026-06-02T09:52:06.655Z","changelog":"xiaohongshu-rank-tracker v1.0.1 - Renamed skill: now called \"xiaohongshu-top-account\" to better reflect the functionality. - Added English and Chinese README files for improved documentation and onboarding. - Updated documentation structure: simplified and clarified usage, features, and scenarios. - Removed old skill card file, consolidating information into clearer, user-friendly guides. - No changes to code logic; updates focus on naming and documentation only.","fileCount":9,"zipByteSize":35348},{"version":"1.0.0","createdAt":"2026-05-20T09:57:39.215Z","changelog":"xiaohongshu-rank-tracker 1.0.0 - 初始发布：支持小红书账号排行榜自动查询与分析。 - 可查询全品类/分品类TOP50日榜、周榜、月榜，支持按美妆、健身、旅行等领域筛选。 - 自动生成可视化HTML报告，支持下载查看和导出PDF/高清图。 - 支持定时订阅，自动推送榜单信息。 - 按规范输出Markdown表格和HTML报告，并自动追加订阅服务提示。","fileCount":7,"zipByteSize":30116}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171kp1a76rjevha5b9m61sxv984vncz:xiaohongshu-rank-tracker","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-xiaohongshu-rank-tracker/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-xiaohongshu-rank-tracker/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-xiaohongshu-rank-tracker/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-xiaohongshu-rank-tracker/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-xiaohongshu-rank-tracker/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-xiaohongshu-rank-tracker/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T10:51:27.749Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-xiaohongshu-rank-tracker/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-xiaohongshu-rank-tracker/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-xiaohongshu-rank-tracker/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-xiaohongshu-rank-tracker/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T07:25:59.093Z","emptyReason":null},"readme":"Skill: 小红书热门账号推荐\n\nOwner: redfox-data\n\nSummary: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号\n\nTags: latest:1.0.2\n\nVersion history:\n\nv1.0.2 | 2026-07-28T05:43:18.511Z | user\n\n### xiaohongshu-rank-tracker 1.0.2 更新日志\n\n- 移除了 skill-card.md 说明文件，无其他功能或逻辑变更。\n- 文档简化和部分描述调整，保持 Skill 主体功能不变。\n\nv1.0.1 | 2026-06-02T09:52:06.655Z | user\n\nxiaohongshu-rank-tracker v1.0.1\n\n- Renamed skill: now called \"xiaohongshu-top-account\" to better reflect the functionality.\n- Added English and Chinese README files for improved documentation and onboarding.\n- Updated documentation structure: simplified and clarified usage, features, and scenarios.\n- Removed old skill card file, consolidating information into clearer, user-friendly guides.\n- No changes to code logic; updates focus on naming and documentation only.\n\nv1.0.0 | 2026-05-20T09:57:39.215Z | user\n\nxiaohongshu-rank-tracker 1.0.0\n\n- 初始发布：支持小红书账号排行榜自动查询与分析。\n- 可查询全品类/分品类TOP50日榜、周榜、月榜，支持按美妆、健身、旅行等领域筛选。\n- 自动生成可视化HTML报告，支持下载查看和导出PDF/高清图。\n- 支持定时订阅，自动推送榜单信息。\n- 按规范输出Markdown表格和HTML报告，并自动追加订阅服务提示。\n\nArchive index:\n\nArchive v1.0.2: 9 files, 34876 bytes\n\nFiles: README.en.md (4296b), README.md (3778b), references/api_docs.md (6205b), references/score_rules.md (989b), scripts/fetch_rank.py (40621b), scripts/generate_report.py (20262b), skill-card.md (2490b), SKILL.md (14758b), _meta.json (143b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: xiaohongshu-top-account\ndescription: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号\n---\n\n# 小红书热门账号推荐\n\n## 概述\n\n本 Skill 基于 `https://redfox.hk/story/api/xhsData/query` 数据接口，\n提供小红书全品类/分品类账号每日/每周/每月的表现榜单查询。支持三大核心能力：\n1. **排名查询** — 查日榜、周榜、月榜 TOP50\n2. **领域查询** — 按品类筛选（美妆、美食、旅行、母婴、健身/体育锻炼等）\n3. **报告下载** — 生成 HTML 可视化报告，支持导出 PDF/截图\n4. **定时订阅** — 设置自动化定时推送\n\n---\n\n## 鉴权\n\n#### 获取 API Key\n\n请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 获取API KEY\n\n#### 配置 API Key\n\n方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中\n\n```bash\n{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }\n```\n\n方案2: 终端配置：export REDFOX_API_KEY=\"ak_xxxx...\"\n\n```bash\nexport REDFOX_API_KEY=\"ak_xxxx...\"\n```\n\n---\n\n## 触发词与意图识别\n\n| 用户意图 | 典型触发词 | 对应操作 |\n|---|---|---|\n| 排名查询 | 小红书日榜、周榜、月榜、TOP50、最夯账号、排行榜、最新推荐 | 调用 API 并格式化输出 |\n| 领域查询 | 美妆类/美食类/旅行类/母婴类/健身类...小红书排名 | 调用 API 并按 category 筛选 |\n| 报告下载 | 下载报告、导出榜单、生成报告 | 使用 --html 参数自动生成 HTML |\n| 定时订阅 | 订阅日榜/周榜/月榜、定时推送、每天发给我 | 创建 WorkBuddy Automation |\n\n---\n\n## 执行流程\n\n### 严格输出顺序（必须按顺序执行，不得跳过）\n\n**第一步：内容输出**\n1. 调用脚本查询榜单数据（默认只查20条）：\n ```bash\n python scripts/fetch_rank.py --query \"用户原始问题\" --limit 20 --html\n ```\n2. 按标准模板格式化输出榜单数据（Markdown 表格形式，最多20条）\n\n**第二步：询问定时订阅**\n- 输出完榜单数据后，**直接**追加以下询问（不等待用户回复）：\n ```\n 📬 订阅服务\n 1️⃣ 是否需要订阅每日/周/月的小红书账号最新排名，订阅后定时推送给您？\n2️⃣ 是否需要订阅具体赛道的账号表现？我们支持：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n\n**第三步：交付 HTML 报告**\n- 脚本已自动生成HTML文件，使用 deliver_attachments 工具交付脚本输出的 HTML 文件路径\n- 追加以下内容：\n ```\n ⚡ 更多操作\n • 点击下方下载HTML报告文件，可在浏览器中打开查看，支持一键导出PDF/高清图片\n • 本次榜单完整共50条数据，是否需要查看全部？\n ```\n\n**用户表示需要查看全部数据时：**\n\n> ⚠️ **强制要求**：必须同时输出 Markdown 表格和交付 HTML 报告，两者缺一不可。\n\n1. 重新调用脚本获取完整50条数据：\n ```bash\n python scripts/fetch_rank.py --query \"用户原始问题\" --limit 50 --html\n ```\n2. 在对话中输出完整50条数据的 Markdown 表格（按标准模板格式）\n3. **必须使用 deliver_attachments 交付 HTML 文件**（关键步骤，不可遗漏），告知用户\"以下是完整50条数据的 HTML 报告，可直接点击下载查看\"\n\n---\n\n### 流程一：排名查询（推荐：自然语言模式）\n\n**直接传入用户原始问题**，脚本自动完成全部解析：\n```bash\npython scripts/fetch_rank.py --query \"用户原始问题\" --limit 20 --html\n```\n\n**自动解析逻辑：**\n\n#### ① 时间判断与日期计算\n\n根据当前时间判断最新数据是否已更新：\n\n| 榜单类型 | 更新时间 | 当前时间 < 更新时间 | 当前时间 >= 更新时间 |\n|---------|---------|-------------------|-------------------|\n| 日榜 | 每日 19:00 | 取前2天 (offset=2) | 取前一天 (offset=1) |\n| 周榜 | 每周一 15:00 | 取前2周 (offset=2) | 取前1周 (offset=1) |\n| 月榜 | 每月1日 上午9:00 | 取前2月 (offset=2) | 取前1月 (offset=1) |\n\n**日期计算公式：**\n- 日榜：`date.today() - timedelta(days=offset)`\n- 周榜：`date.today() - timedelta(weeks=offset)` 后的最近周一\n- 月榜：`date.today() - timedelta(days=30*offset)` 后的每月1日\n\n**更新规则（输出时告知用户）：**\n- 日榜：每日 **19:00** 更新\n- 周榜：每周一 **15:00** 更新\n- 月榜：每月 **1日 9:00** 更新\n#### ② 周期判断\n\n自动从用户文本中识别日/周/月（无明确则默认**日榜**）：\n- 含\"周\"/\"周榜\"→ `week`\n- 含\"月\"/\"月榜\"→ `month`\n- 其余默认 → `day`\n\n#### ③ 回溯范围校验\n\n| 榜单类型 | 最大回溯 | 超范围处理 |\n|---------|---------|-----------|\n| 日榜 | 近7天 | 自动切换至最近可用日期 |\n| 周榜 | 近3周 | 自动切换至最近可用日期 |\n| 月榜 | 近3个月 | 自动切换至最近可用日期 |\n\n**超出范围时**：-若用户查询当日及未来日期的榜单，在榜单说明输出中增加：「非常抱歉🙏，我们最新的是昨日/上周/上月的数据，将为您提供最接近您需求的昨日/上周/上月热榜。」\n-若用户查询时间早于回溯日期，在榜单说明输出中增加回复：「非常抱歉🙏，目前榜单最多支持回溯「过去7天/过去3周/过去3月」，我将为您查询最接近您需求的时间范围~」\n\n#### ④ 赛道（type）匹配\n\n支持模糊匹配，映射表见 `references/api_docs.md`。\n\n**常用映射：**\n| 用户说 | 映射到 |\n|--------|--------|\n| 健身、运动、瑜伽 | 体育锻炼 |\n| 美妆、彩妆、护肤 | 化妆美容/个人护理 |\n| 美食、探店、烹饪 | 美味佳肴 |\n| 旅行、旅游 | 旅行度假 |\n| 母婴、育儿 | 亲子育儿 |\n| 穿搭、时尚 | 时尚穿搭 |\n\n若无法匹配，输出综合全部，并告知用户无法识别的赛道类别。\n\n#### ⑤ 数据回退机制\n\n**重要**：部分分类（如体育锻炼）在某些日期可能返回空数据。此时应：\n1. 自动尝试前一个日期\n2. 最多回退3天\n3. 若仍无数据，告知用户该分类在该时间段暂无数据\n\n---\n\n### 流程二：报告下载\n\n1. 查询时加 `--html --limit 50` 参数，脚本会自动生成HTML报告\n2. 调用 `deliver_attachments` 交付 HTML 文件（账号名均可点击跳转小红书主页）\n\n---\n\n### 流程三：定时订阅\n\n1. 询问订阅周期（每日 / 每周 / 每月）。\n2. 使用 `automation_update` 创建自动化任务：\n - 每日订阅：`FREQ=DAILY;BYHOUR=8;BYMINUTE=0`\n - 每周订阅：`FREQ=WEEKLY;BYDAY=MO;BYHOUR=8;BYMINUTE=0`\n - 每月订阅：`FREQ=WEEKLY;BYDAY=MO;BYHOUR=8;BYMINUTE=0;INTERVAL=4`\n3. automation prompt：`查询小红书最新{period}榜（综合全部）并推送给用户`\n\n---\n\n## 标准输出模板\n\n**必须按以下顺序输出，不得跳过任何步骤：**\n\n### 第一步：内容输出\n```\n📊 小红书{period_label} · {category_label}\n\n数据日期：{date}\n共 {total} 个账号上榜\n\n💡 榜单说明：{period_update_time}更新昨日/上周/上月数据。\n\n📐 排名算法：排名根据达人在小红书的**总粉丝数**、周期内的**粉丝增量**、**点赞增量**、**收藏增量**、**分享增量**以及**评论增量**加权计算所得，满分100分。\n\n| 排名 | 账号名 | 综合评分 | 总粉丝数 | 新增笔记 | 新增粉丝 | 新增点赞 | 新增评论 | 新增收藏 | 新增分享 |\n|:---:|--------|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|\n| 🥇 1 | 账号A · 赛道 | 96 | 254.06w | 7 | 6919 | 24.64w | 6.68w | 2.53w | 13.39w |\n| 🥈 2 | 账号B · 赛道 | 89 | 113.55w | 1 | 1.91w | 7.90w | 4787 | 2.18w | 3.12w |\n| 🥉 3 | 账号C · 赛道 | 87 | 439.14w | 2 | 5859 | 16.51w | 993 | 7688 | 687 |\n| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |\n\n统计概览：上榜账号 {total} · 最高互动 {max_interaction} · 总新增笔记 {total_notes}\n\n```\n\n### 第二步：询问定时订阅（直接追加，不等待回复）\n```\n📬 订阅服务\n1️⃣ 是否需要订阅每日/周/月的小红书账号最新排名，订阅后定时推送给您？\n2️⃣ 是否需要订阅具体赛道的账号表现？我们支持：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n```\n\n**用户回复\"需要订阅\"时**，使用 `calendar_create` 工具创建日程：\n- 参数：\n - `title`: 小红书{period_label}榜单推送\n - `description`: 订阅小红书{period_label}榜单，自动查询并推送最新排名数据\n - `start_time`: 根据订阅周期计算（每日08:00/每周一08:00/每月1日08:00）\n - `end_time`: start_time 后1小时\n - `reminder`: 0（不需要提醒）\n- 创建成功后告知用户日程已创建\n\n### 第三步：交付 HTML 报告（必须交付）\n\n> ⚠️ **强制要求**：必须立即使用 deliver_attachments 交付文件，不得仅提示用户下载而不实际交付。\n\n- 脚本已自动生成HTML文件（路径在输出末尾）\n- **必须使用 deliver_attachments 交付 HTML 文件**（这是关键步骤，遗漏将导致用户看不到报告）\n- 交付后追加以下提示：\n```\n⚡ 更多操作\n• 点击下方下载HTML报告文件，可在浏览器中打开查看，支持一键导出PDF/高清图片\n• 本次榜单完整共50条数据，是否需要查看全部？\n```\n\n> ⚠️ **字段说明**：\n> - **最高互动**：互动总数 = 点赞 + 评论 + 收藏 + 分享，取榜单中互动最高的账号\n> - 当前接口仅返回各细分字段（总粉丝数、新增粉丝、新增点赞、新增评论、新增收藏、新增分享）\n> - 赛道展示在账号名下方，使用 \"账号名 · 赛道\" 格式\n\n---\n\n## HTML 报告模板规范\n\n### 表格列规范\n\n| 列名 | 说明 |\n|------|------|\n| 排名 | 1-3名使用金银铜牌样式，其余使用灰色徽章 |\n| 账号名 | 可点击跳转小红书主页，赛道展示在账号名下方 |\n| 总粉丝数 | 格式：254.06w |\n| 新增笔记 | 整数 |\n| 新增粉丝 | 整数或带 w 单位 |\n| 新增点赞 | 带 w 单位 |\n| 新增评论 | 整数或带 w 单位 |\n| 新增收藏 | 整数或带 w 单位 |\n| 新增分享 | 整数或带 w 单位 |\n\n**注意**：不展示综合评分列，表格从11列减少到9列。\n\n### 统计卡片规范\n\n| 指标 | 说明 |\n|------|------|\n| 上榜账号 | 榜单总数，默认50 |\n| 最高互动 | 互动总数 = 点赞 + 评论 + 收藏 + 分享 |\n| 总新增笔记 | 所有账号新增笔记之和 |\n\n### 榜单说明与排名算法\n\n```html\n
\n
💡 榜单说明：{period_update_desc}更新，与实时数据存在差异。
\n
📐 排名算法：排名根据达人在小红书的 总粉丝数、周期内的 粉丝增量、点赞增量、收藏增量、分享增量 以及 评论增量 加权计算所得。
\n
\n```\n\n---\n\n## API 参数说明\n\n### 接口信息\n- **URL**：`POST https://onetotenvip.com/story/xhsData/query`\n- **成功码**：`code: 2000`（非0！）\n\n### 请求参数\n\n| 参数名 | 类型 | 说明 | 示例 |\n|--------|------|------|------|\n| dateType | int | 榜单类型：1=日榜, 2=周榜, 3=月榜 | 1 |\n| rankDate | string | 日期（格式：YYYY-MM-DD） | \"2026-04-28\" |\n| type | string | 赛道名称（中文） | \"体育锻炼\" |\n| source | string | **必须为** `小红书指数榜-ClawHub` | \"小红书指数榜\" |\n\n### 各榜单日期参数\n\n| 榜单类型 | rankDate 格式 | 示例 | offset计算 |\n|----------|--------------|------|-----------|\n| 日榜 | YYYY-MM-DD（前一天或前两天） | \"2026-04-28\" | 当前时间<19:00→offset=2, ≥19:00→offset=1 |\n| 周榜 | YYYY-MM-DD（周一） | \"2026-04-20\" | 当前时间周一<15:00→offset=2, 否则→offset=1 |\n| **月榜** | **YYYY-MM-02（每月1日）** | **\"2026-04-02\"** | 当前时间2号<09:00→offset=2, 否则→offset=1 |\n\n### 返回字段\n\n| 字段 | 说明 |\n|------|------|\n| accountName | 账号名 |\n| category | 赛道分类 |\n| followers | 总粉丝数 |\n| newNoteCount | 新增笔记数 |\n| newFans | 新增粉丝 |\n| newLikes | 新增点赞 |\n| newComments | 新增评论 |\n| newCollects | 新增收藏 |\n| newShares | 新增分享 |\n| profileUrl | 小红书主页链接 |\n\n---\n\n## 使用示例\n\n### 示例1：查询美妆类日榜\n- 场景/输入：用户说\"小红书美妆日榜\"\n- 预期产出：返回美妆类当日 TOP20 榜单数据\n- 关键要点：自动解析赛道为\"化妆美容\"，日期自动计算为最新可用日期\n\n### 示例2：查询美食类周榜\n- 场景/输入：用户说\"最新美食周榜\"\n- 预期产出：返回美食类上周榜单\n- 关键要点：自动解析周期为 week，赛道为\"美味佳肴\"\n\n### 示例3：生成 HTML 报告\n- 场景/输入：用户需要导出完整报告\n- 预期产出：生成可下载的 HTML 文件\n- 关键要点：调用 fetch_rank.py 时加 --html 参数自动生成HTML报告\n\n---\n\n## 资源索引\n\n- 脚本:见 [scripts/fetch_rank.py](scripts/fetch_rank.py)(用途:查询小红书榜单数据)\n- 脚本:见 [scripts/generate_report.py](scripts/generate_report.py)(用途:被 fetch_rank.py --html 调用生成 HTML)\n- 参考:见 [references/api_docs.md](references/api_docs.md)(何时读取:需要查看 API 详细参数说明时)\n\n---\n\n## 注意事项\n\n- 日榜默认展示 TOP 20，完整 50 条通过报告或追问查看。\n- 赛道关键词支持 LLM 语义模糊匹配，实在无法识别时降级为综合全部。\n- HTML 报告账号名均可点击跳转小红书主页（基于 `profileUrl` 字段）。\n- 生成报告前确保 workspace 有写权限。\n- **最高互动**需要根据点赞+评论+收藏+分享计算，不能直接使用接口返回的 `newInteraction` 字段（该字段值可能为0）。\n- **月榜日期参数必须使用每月1日**，如查询上月榜单用 \"2026-04-02\"。\n- **体育锻炼分类**：部分日期可能返回空数据，需要自动回退日期。\n\nFile v1.0.2:README.md\n\n# 小红书热门账号推荐 / xiaohongshu-top-account\n\n---\n\n## 简介\n\n想看小红书哪些账号最火、涨粉最猛？直接说品类就能查日榜、周榜、月榜 TOP50，覆盖美妆、美食、旅行、母婴等 25 个赛道，排名数据每日更新，自动生成可视化报告。\n\n**核心价值**\n\n- **榜单全面不遗漏** — 日榜/周榜/月榜三大周期，综合全部或细分赛道，TOP50 账号一目了然。\n- **品类精准不跑偏** — 说\"美食\"自动匹配美味佳肴赛道，说\"健身\"锁定体育锻炼，模糊词也能识别。\n- **报告直观可导出** — 自动生成精美 HTML 报告，支持一键导出 PDF/高清图片，账号名可直接跳转主页。\n- **订阅推送不操心** — 设置每日/每周/每月定时推送，榜单数据自动送到你面前。\n\n**适用对象**\n\n- 📊 **品牌/MCN 运营** — 快速锁定各赛道头部达人，为投放和合作提供数据支撑。\n- 📝 **小红书博主** — 了解同赛道热门账号动态，找到对标和学习对象。\n- 🔍 **内容研究者** — 跨品类、跨周期对比账号表现，洞察平台流量趋势。\n\n---\n\n## 功能特性\n\n### 核心功能\n\n- **排名查询**：查日榜、周榜、月榜 TOP50，默认展示 TOP20，追问即可查看全部。\n- **品类筛选**：支持 25 个赛道精准查询（美妆、美食、旅行、母婴、健身等），说赛道名自动匹配。\n- **可视化报告**：每次查询自动生成 HTML 报告，账号名可点击跳转主页，支持导出 PDF。\n- **定时订阅**：设置推送周期（每日/每周/每月），榜单数据定时送到你面前。\n- **历史回溯**：日榜回溯近 7 天，周榜近 3 周，月榜近 3 个月。\n\n---\n\n## 密钥获取与安全说明\n\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`) 提供。\n- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\n\n---\n\n## 使用指南\n\n直接用自然语言描述需求，无需记忆命令。\n\n### 常用说法速查\n\n| 意图 | 示例话术 | 效果 |\n|------|----------|------|\n| 查综合日榜 | \"小红书最新日榜\" | 返回全品类昨日 TOP20 账号排名 |\n| 查品类周榜 | \"美食周榜\" | 返回美味佳肴赛道上周 TOP20 |\n| 查月榜 | \"美妆月榜\" | 返回化妆美容赛道上月 TOP20 |\n| 查看全部 | \"看全部50条\" | 展开完整 TOP50 榜单并交付报告 |\n| 下载报告 | \"下载报告\" | 生成并交付 HTML 可视化报告文件 |\n| 订阅推送 | \"订阅每日榜单\" | 设置每日定时推送榜单数据 |\n\n### 输出示例\n\n查询后你会收到结构化的榜单表格，包含排名、账号名（可点击跳转主页）、综合评分、总粉丝数、新增笔记/粉丝/点赞/评论/收藏/分享等指标，并自动附带 HTML 报告文件。\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 示例问法 | 收益 |\n|------|------|----------|------|\n| 达人筛选 | 品牌/MCN | \"旅行赛道日榜，看看哪些账号最近涨粉猛\" | 快速锁定合作对象，数据说话 |\n| 竞品追踪 | 博主/运营 | \"订阅美妆赛道的每周排名\" | 定期收到同赛道头部账号动态 |\n| 趋势洞察 | 内容研究 | \"对比一下美食和健身赛道的月榜\" | 跨品类数据对比，发现流量趋势 |\n| 报告导出 | 数据分析 | \"查综合月榜，导出报告\" | 得到可分享的 HTML 报告文件 |\n\n---\n\nFile v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n \"slug\": \"xiaohongshu-rank-tracker\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1785217398511\n}\n\nFile v1.0.2:references/api_docs.md\n\n# 小红书榜单 API 接口文档\n\n## 接口基础信息\n\n| 字段 | 值 |\n|------|-----|\n| 接口地址 | `https://onetotenvip.com/story/xhsData/query` |\n| 请求方式 | POST |\n| Content-Type | `application/json` |\n| 认证方式 | 无（公开接口） |\n\n---\n\n## 请求参数（已校验）\n\n```json\n{\n \"dateType\": 1, // 榜单日期类型：1=日榜 2=周榜 3=月榜（必填）\n \"rankDate\": \"2026-04-28\", // 榜单日期 yyyy-MM-dd（必填）\n // 日榜：填当日日期，如 2026-04-28\n // 周榜：填该周**周一**日期，如 2026-04-20\n // 月榜：填该月第一天，如 2026-03-01\n \"type\": \"体育锻炼\", // 赛道分类，默认\"综合全部\"（必填）\n \"source\": \"小红书指数榜-ClawHub\" // 固定值（必填）\n}\n```\n\n> ⚠️ **重要**：`source` 必须为 `\"小红书指数榜\"`，使用其他值会导致接口返回空数据！\n> \n> ⚠️ 注意：`page`/`pageSize` 参数无效，接口每次固定返回 50 条数据。\n\n---\n\n## 响应结构（实际返回）\n\n```json\n{\n \"code\": 2000,\n \"data\": [\n {\n \"accountLink\": \"https://www.xiaohongshu.com/user/profile/...\",\n \"accountName\": \"恋与深空\",\n \"accountRanking\": 1,\n \"category\": \"数码科技\",\n \"fansCount\": \"254.06w\",\n \"fansGrowth\": \"6919\",\n \"likedGrowth\": \"24.64w\",\n \"commentsGrowth\": \"6.68w\",\n \"collectedGrowth\":\"2.53w\",\n \"sharedGrowth\": \"13.39w\",\n \"newNoteCount\": null,\n \"dataFetchTime\": \"2026-04-29 19:00:01\",\n \"rankDate\": \"2026-04-28\",\n \"rankPeriod\": \"日榜\"\n }\n ]\n}\n```\n\n> ⚠️ 注意：新接口**不返回** `comprehensiveScore`（综合评分）字段； \n> 互动数各字段均为**字符串格式**，如 `\"6.68w\"`、`\"1245\"`。\n\n---\n\n## 错误码\n\n| code | 含义 |\n|------|------|\n| 2000 | **成功**（注意：成功码是 2000 不是 0！） |\n| 其他 | 错误，data 为空数组 |\n\n---\n\n## 字段映射（fetch_rank.py normalized JSON）\n\n| 接口原始字段 | normalized 字段 | 含义 |\n|------------|----------------|------|\n| `accountRanking` | `rank` | 排名 |\n| `accountName` | `accountName` | 账号名 |\n| `category` | `category` | 赛道 |\n| `fansCount` | `followers` | 总粉丝数 |\n| `newNoteCount` | `newNoteCount` | 新增笔记数 |\n| `fansGrowth` | `newFans` | 新增粉丝 |\n| `likedGrowth` | `newLikes` | 新增点赞 |\n| `commentsGrowth` | `newComments` | 新增评论 |\n| `collectedGrowth` | `newCollects` | 新增收藏 |\n| `sharedGrowth` | `newShares` | 新增分享 |\n| `accountLink` | `profileUrl` | 主页链接 |\n\n---\n\n## 可用品类列表\n\n```\n综合全部\n出行代步 / 休闲爱好 / 影视娱乐 / 数码科技 / 医疗保健 / 综合杂项\n星座情感 / 时尚穿搭 / 婚庆婚礼 / 拍摄记录 / 学习教育 / 化妆美容\n居家装修 / 旅行度假 / 亲子育儿 / 个人护理 / 美味佳肴 / 职业发展\n宠物天地 / 潮流鞋包 / 日常生活 / 科学探索 / 新闻资讯 / 体育锻炼\n```\n\n**常用别名映射：**\n| 用户说 | 映射到 |\n|--------|--------|\n| 健身、运动、瑜伽 | 体育锻炼 |\n| 美妆、彩妆、护肤 | 化妆美容/个人护理 |\n| 美食、探店、烹饪 | 美味佳肴 |\n| 旅行、旅游 | 旅行度假 |\n| 母婴、育儿 | 亲子育儿 |\n| 穿搭、时尚 | 时尚穿搭 |\n\n---\n\n## 榜单更新规则\n\n| 榜单类型 | 更新时间 | 统计范围 | rankDate 填写规则 | 示例 |\n|---------|---------|---------|-----------------|------|\n| 日榜 | 每日 19:00 | 前一天 | 填当天日期 | \"2026-04-28\" |\n| 周榜 | 每周一 15:00 | 上周 | 填该周**周一**日期 | \"2026-04-20\" |\n| 月榜 | 每月1日 上午9:00 | 上月 | 填该月**1日** | \"2026-04-01\" |\n\n### 日期回退计算\n\n根据当前时间判断取第几期数据：\n\n| 榜单类型 | 当前时间 < 更新时间 | 当前时间 >= 更新时间 |\n|---------|-------------------|-------------------|\n| 日榜 (19:00更新) | offset=2 (前2天) | offset=1 (前1天) |\n| 周榜 (周一15:00更新) | offset=2 (前2周) | offset=1 (前1周) |\n| 月榜 (2号09:00更新) | offset=2 (前2月) | offset=1 (前1月) |\n\n> ⚠️ **月榜必须用每月1日**，实测用月末最后一天（如 \"2026-03-31\"）返回空数据！\n\n> ⚠️ **周榜用周一日期**，实测用周日日期（如 \"2026-04-20\" 周日）会返回空数据！\n\n---\n\n## 常见问题\n\n### 1. 体育锻炼分类数据为空\n\n部分分类（如体育锻炼）在某些日期可能返回空数据。需要自动回退日期尝试：\n```\n2026-04-29: 0条 → 回退\n2026-04-28: 50条 ✓\n```\n\n### 2. 互动数据计算\n\n最高互动需要自行计算：\n```python\ndef parse_num(s):\n s = str(s).replace('w', '').replace('W', '')\n if '.' in s:\n return float(s) * 10000\n return float(s)\n\ninteraction = parse_num(item['newLikes']) + \\\n parse_num(item['newComments']) + \\\n parse_num(item['newCollects']) + \\\n parse_num(item['newShares'])\n```\n\n> ⚠️ 接口返回的 `newInteraction` 字段值可能为0，不要直接使用！\n\n---\n\n## Python 调用示例\n\n```python\nimport requests\nfrom datetime import date, timedelta\n\nurl = \"https://onetotenvip.com/story/xhsData/query\"\n\n# 日榜示例（体育锻炼）\npayload_day = {\n \"dateType\": 1,\n \"rankDate\": \"2026-04-28\",\n \"type\": \"体育锻炼\",\n \"source\": \"小红书指数榜-ClawHub\"\n}\n\n# 周榜示例\npayload_week = {\n \"dateType\": 2,\n \"rankDate\": \"2026-04-20\", # 上周周一\n \"type\": \"综合全部\",\n \"source\": \"小红书指数榜-ClawHub\"\n}\n\n# 月榜示例\npayload_month = {\n \"dateType\": 3,\n \"rankDate\": \"2026-04-01\", # 上月1日\n \"type\": \"综合全部\",\n \"source\": \"小红书指数榜-ClawHub\"\n}\n\nresp = requests.post(url, json=payload_day, timeout=15)\ndata = resp.json()\n\nif data[\"code\"] == 2000: # 注意：成功码是 2000\n print(f\"获取到 {len(data['data'])} 条数据\")\n for item in data[\"data\"]:\n print(item[\"accountRanking\"], item[\"accountName\"],\n item[\"fansCount\"], item[\"likedGrowth\"])\nelse:\n print(f\"接口返回错误: {data}\")\n```\n\nFile v1.0.2:references/score_rules.md\n\n# 小红书账号综合评分规则\n\n## 评分维度\n\n综合评分基于以下维度计算：\n\n| 维度 | 权重 | 计算方式 |\n|------|------|----------|\n| 总粉丝数 | 20% | ln(x+1)/ln(max+1) × 100 |\n| 新增粉丝 | 20% | ln(x+1)/ln(max+1) × 100 |\n| 新增点赞 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增收藏 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增分享 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增评论 | 15% | ln(x+1)/ln(max+1) × 100 |\n\n## 计算公式\n\n对数归一化公式：\n```\nscore = ln(x + 1) / ln(max + 1) × 100\n```\n\n其中：\n- `x` 为该账号的当前指标值\n- `max` 为本次榜单中该指标的最大值\n\n## 示例\n\n假设某榜单数据如下：\n\n| 账号 | 新增点赞 | 得分计算 |\n|------|----------|----------|\n| A | 10万 | ln(100001)/ln(100001) × 100 = 100 |\n| B | 5万 | ln(50001)/ln(100001) × 100 ≈ 85 |\n| C | 1万 | ln(10001)/ln(100001) × 100 ≈ 67 |\n\n## 最终得分\n\n各维度加权求和后，保留整数作为综合评分。\n\nFile v1.0.2:README.en.md\n\n# Xiaohongshu Top Account Tracker / xiaohongshu-top-account\n\n---\n\n## Overview\n\nWant to know which Xiaohongshu accounts are hottest and gaining followers the fastest? Just say a category to check daily, weekly, or monthly TOP 50 rankings across 25 niches including beauty, food, travel, parenting, and fitness. Rankings are updated daily, and a visual report is generated automatically.\n\n**Core Value**\n\n- **Comprehensive rankings** — Daily/weekly/monthly cycles, all categories or niche-specific, TOP 50 accounts at a glance.\n- **Accurate niche matching** — Say \"food\" and it auto-matches to the gourmet niche; say \"fitness\" and it locks onto sports & exercise. Fuzzy keywords work too.\n- **Visual & exportable reports** — Automatically generates a polished HTML report with one-click PDF/image export; account names link directly to their profiles.\n- **Hands-free subscriptions** — Set up daily/weekly/monthly push notifications and rankings come to you automatically.\n\n**Intended Users**\n\n- 📊 **Brand / MCN operators** — Quickly identify top creators in each niche for collaboration and investment decisions.\n- 📝 **Xiaohongshu creators** — Stay up to date on top accounts in your niche and find benchmarks to learn from.\n- 🔍 **Content researchers** — Compare account performance across niches and cycles to spot platform traffic trends.\n\n---\n\n## Features\n\n### Core Capabilities\n\n- **Ranking queries**: Check daily, weekly, or monthly TOP 50 — default display shows TOP 20, ask to see the full list.\n- **Niche filtering**: Supports 25 niches (beauty, food, travel, parenting, fitness, etc.) with automatic name matching.\n- **Visual reports**: Each query auto-generates an HTML report; account names are clickable links to their profiles, with PDF export support.\n- **Scheduled subscriptions**: Set a push cycle (daily/weekly/monthly) and rankings are delivered on schedule.\n- **History lookback**: Daily rankings go back 7 days, weekly 3 weeks, monthly 3 months.\n\n---\n\n## API Key Acquisition & Security\n\n- This skill requires the environment variable: `REDFOX_API_KEY`.\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`).\n- Register at [RedFoxHub](https://redfox.hk?source=github) to obtain `REDFOX_API_KEY`.\n- Configure `REDFOX_API_KEY` on your device before using this skill.\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\n\n---\n\n## Usage Guide\n\nSimply describe what you need in natural language—no commands to memorize.\n\n### Quick Reference\n\n| Intent | Example phrase | Result |\n|--------|---------------|--------|\n| Daily all-category ranking | \"Xiaohongshu latest daily ranking\" | Returns yesterday's all-category TOP 20 account ranking |\n| Weekly niche ranking | \"Food weekly ranking\" | Returns last week's gourmet niche TOP 20 |\n| Monthly ranking | \"Beauty monthly ranking\" | Returns last month's cosmetics niche TOP 20 |\n| View full list | \"Show all 50\" | Expands the complete TOP 50 ranking and delivers the report |\n| Download report | \"Download report\" | Generates and delivers an HTML visual report file |\n| Subscribe to push | \"Subscribe to daily ranking\" | Sets up daily scheduled ranking push notifications |\n\n### Output Example\n\nAfter a query you receive a structured ranking table including rank, account name (clickable to profile), composite score, total followers, new notes/followers/likes/comments/saves/shares, along with an HTML report file.\n\n---\n\n## Use Cases\n\n| Scenario | Role | Example question | Benefit |\n|----------|------|-----------------|---------|\n| Creator screening | Brand / MCN | \"Travel niche daily ranking—who's gaining followers fast?\" | Quickly identify collaboration targets backed by data |\n| Competitor tracking | Creator / ops | \"Subscribe to beauty niche weekly ranking\" | Receive regular updates on top accounts in your niche |\n| Trend insights | Content research | \"Compare food and fitness monthly rankings\" | Cross-niche data comparison to spot traffic trends |\n| Report export | Data analysis | \"Check all-category monthly ranking and export report\" | Get a shareable HTML report file |\n\n---\n\nFile v1.0.2:skill-card.md\n\n## Description:\n\n小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[redfox-data](https://clawhub.ai/user/redfox-data)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nBrand and MCN operators, Xiaohongshu creators, and content researchers use this skill to query daily, weekly, or monthly Xiaohongshu TOP 50 account rankings by category, generate shareable HTML reports, and optionally set recurring ranking updates.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill requires a RedFox API key and calls an external ranking API.\n\nMitigation: Verify the API key source, scope, validity period, and revocation path, and keep the key out of prompts, logs, code, and generated outputs.\n\nRisk: Generated HTML reports are active web pages and may contain external account links.\n\nMitigation: Open only reports generated from trusted data and review profile links before following or sharing them.\n\nRisk: Optional subscriptions can create recurring ranking pushes.\n\nMitigation: Confirm the requested schedule and cancellation path before enabling a recurring subscription.\n\nRisk: The release security verdict is suspicious because report generation and subscription behavior require review.\n\nMitigation: Review the skill before installing or enabling automation, following the release security guidance.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/redfox-data/skills/xiaohongshu-rank-tracker)\n- [Xiaohongshu Ranking API Documentation](references/api_docs.md)\n- [Xiaohongshu Account Scoring Rules](references/score_rules.md)\n- [RedFox API Key Settings](https://redfox.hk/settings/api-keys?source=clawhub)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Files, Shell commands, Configuration guidance]\n\n**Output Format:** [Markdown ranking tables with optional downloadable HTML report files and JSON output]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires REDFOX_API_KEY; HTML reports may include Xiaohongshu profile links and client-side export controls.]\n\n## Skill Version(s):\n\n1.0.2 (source: release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.1: 9 files, 35348 bytes\n\nFiles: README.en.md (6981b), README.md (6687b), references/api_docs.md (8076b), references/score_rules.md (989b), scripts/fetch_rank.py (36104b), scripts/generate_report.py (20262b), skill-card.md (2494b), SKILL.md (10526b), _meta.json (143b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: xiaohongshu-top-account\ndescription: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号\n---\n\n# 小红书热门账号推荐\n\n## 1. 简介\n\n小红书账号榜单追踪分析工具 -- 基于红狐数据 API，提供小红书全品类 / 分品类账号每日 / 每周 / 每月的表现榜单查询，支持排名查询、赛道筛选、HTML 可视化报告下载与定时订阅推送。\n\n**适用对象**：内容创作者、品牌方、MCN 机构、行业分析师。\n\n---\n\n## 2. 功能特性\n\n**核心功能**：\n\n- 排名查询 -- 查日榜、周榜、月榜 TOP50\n- 赛道筛选 -- 按品类筛选（美妆、美食、旅行、母婴、健身等 25 个赛道）\n- 报告下载 -- 生成 HTML 可视化报告，支持导出 PDF / 截图\n- 定时订阅 -- 设置自动化定时推送\n\n**特色亮点**：\n\n- 日榜每日 19:00 更新，周榜每周一 15:00 更新，月榜每月 2 号 9:00 更新\n- 自动解析用户自然语言输入（时间、周期、赛道），无需记忆命令格式\n- 排名算法：根据总粉丝数、粉丝增量、点赞增量、收藏增量、分享增量、评论增量加权计算，满分 100 分\n- 数据回退机制：部分分类返回空数据时自动回退最多 3 天\n- HTML 报告账号名均可点击跳转小红书主页\n\n---\n\n## 3. 一键安装\n\n### 鉴权\n\n#### 获取 API Key\n\n请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 获取API KEY\n\n#### 配置 API Key\n\n方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中\n\n```bash\n{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }\n```\n\n方案2: 终端配置：export REDFOX_API_KEY=\"ak_xxxx...\"\n\n```bash\nexport REDFOX_API_KEY=\"ak_xxxx...\"\n```\n\n### 依赖安装\n\n无需安装第三方依赖，使用 Python 标准库 `urllib` 发送请求即可。\n\n---\n\n## 4. 使用指南\n\n### 基础使用\n\n**排名查询（推荐：自然语言模式）**：\n\n直接传入用户原始问题，脚本自动完成全部解析：\n\n```bash\npython scripts/fetch_rank.py --query \"用户原始问题\" --limit 20 --html\n```\n\n**脚本自动解析逻辑**：\n\n- **时间判断与日期计算**：\n\n| 榜单类型 | 更新时间 | 当前时间 < 更新时间 | 当前时间 >= 更新时间 |\n| -------- | ---------------- | ------------------- | -------------------- |\n| 日榜 | 每日 19:00 | 取前2天 (offset=2) | 取前一天 (offset=1) |\n| 周榜 | 每周一 15:00 | 取前2周 (offset=2) | 取前1周 (offset=1) |\n| 月榜 | 每月2号 上午9:00 | 取前2月 (offset=2) | 取前1月 (offset=1) |\n\n- **周期判断**：自动从用户文本中识别日 / 周 / 月（无明确则默认日榜）\n- **回溯范围校验**：\n\n| 榜单类型 | 最大回溯 | 超范围处理 |\n| -------- | -------- | ---------------------- |\n| 日榜 | 近7天 | 自动切换至最近可用日期 |\n| 周榜 | 近3周 | 自动切换至最近可用日期 |\n| 月榜 | 近3个月 | 自动切换至最近可用日期 |\n\n- **赛道（type）匹配**：支持模糊匹配，常用映射：\n\n| 用户说 | 映射到 |\n|--------|--------|\n| 健身、运动、瑜伽 | 体育锻炼 |\n| 美妆、彩妆、护肤 | 化妆美容/个人护理 |\n| 美食、探店、烹饪 | 美味佳肴 |\n| 旅行、旅游 | 旅行度假 |\n| 母婴、育儿 | 亲子育儿 |\n| 穿搭、时尚 | 时尚穿搭 |\n\n- **数据回退机制**：部分分类（如体育锻炼）在某些日期可能返回空数据时，自动尝试前一个日期，最多回退 3 天。\n\n### 严格输出顺序（必须按顺序执行）\n\n**第一步：内容输出** -- 调用 `fetch_rank.py` 查询并格式化输出榜单（Markdown 表格，最多 20 条）。\n\n**第二步：询问定时订阅** -- 输出完榜单后直接追加：\n\n```\n📬 订阅服务\n1️⃣ 是否需要订阅每日/周/月的小红书账号最新排名，订阅后定时推送给您？\n2️⃣ 是否需要订阅具体赛道的账号表现？我们支持：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n```\n\n用户回复 \"需要订阅\" 时，使用 `calendar_create` 工具创建日程。\n\n**第三步：交付 HTML 报告** -- 使用 `deliver_attachments` 交付脚本输出的 HTML 文件。\n\n**用户需要查看全部数据时**：重新调用脚本获取完整 50 条数据，同时输出 Markdown 表格和交付 HTML 报告（两者缺一不可）。\n\n### 输出格式\n\n**Markdown 表格模板**：\n\n```\n📊 小红书{period_label} · {category_label}\n数据日期：{date}\n共 {total} 个账号上榜\n\n💡 榜单说明：{period_update_time}更新昨日/上周/上月数据。\n\n📐 排名算法：排名根据达人在小红书的**总粉丝数**、周期内的**粉丝增量**、**点赞增量**、**收藏增量**、**分享增量**以及**评论增量**加权计算所得，满分100分。\n\n| 排名 | 账号名 | 综合评分 | 总粉丝数 | 新增笔记 | 新增粉丝 | 新增点赞 | 新增评论 | 新增收藏 | 新增分享 |\n|:---:|--------|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|\n| 🥇 1 | 账号A · 赛道 | 96 | 254.06w | 7 | 6919 | 24.64w | 6.68w | 2.53w | 13.39w |\n| 🥈 2 | 账号B · 赛道 | 89 | 113.55w | 1 | 1.91w | 7.90w | 4787 | 2.18w | 3.12w |\n| 🥉 3 | 账号C · 赛道 | 87 | 439.14w | 2 | 5859 | 16.51w | 993 | 7688 | 687 |\n\n统计概览：上榜账号 {total} · 最高互动 {max_interaction} · 总新增笔记 {total_notes}\n```\n\n### 高级使用\n\n**报告下载**：查询时加 `--html --limit 50` 参数，脚本自动生成 HTML 报告。\n\n**定时订阅**：\n- 每日订阅：`FREQ=DAILY;BYHOUR=8;BYMINUTE=0`\n- 每周订阅：`FREQ=WEEKLY;BYDAY=MO;BYHOUR=8;BYMINUTE=0`\n- 每月订阅：`FREQ=WEEKLY;BYDAY=MO;BYHOUR=8;BYMINUTE=0;INTERVAL=4`\n\nautomation prompt：`查询小红书最新{period}榜（综合全部）并推送给用户`\n\n### 常用指令速查\n\n| 用户意图 | 典型触发词 | 对应操作 |\n| -------- | ---------- | -------- |\n| 排名查询 | 小红书日榜、周榜、月榜、TOP50、最夯账号、排行榜、最新推荐 | 调用 API 并格式化输出 |\n| 领域查询 | 美妆类/美食类/旅行类/母婴类/健身类...小红书排名 | 调用 API 并按 category 筛选 |\n| 报告下载 | 下载报告、导出榜单、生成报告 | 使用 --html 参数自动生成 HTML |\n| 定时订阅 | 订阅日榜/周榜/月榜、定时推送、每天发给我 | 创建 WorkBuddy Automation |\n\n### API 参数说明\n\n- **URL**：`POST https://redfox.hk/story/api/xhsData/query`\n- **成功码**：`code: 2000`（非 0）\n- **认证方式**：`X-API-KEY` Header（从环境变量 `REDFOX_API_KEY` 获取）\n- **请求参数**：dateType（1=日榜, 2=周榜, 3=月榜）、rankDate（YYYY-MM-DD）、type（赛道名称）、source（固定为 \"小红书指数榜\"）\n- **月榜日期参数必须使用每月 2 号**（如 \"2026-04-02\"）\n\n### HTML 报告规范\n\n表格列：排名 | 账号名 | 总粉丝数 | 新增笔记 | 新增粉丝 | 新增点赞 | 新增评论 | 新增收藏 | 新增分享\n\n统计卡片：上榜账号、最高互动（点赞+评论+收藏+分享）、总新增笔记\n\n---\n\n## 5. 使用场景\n\n1. **内容创作者找对标**：输入 \"小红书美妆日榜\"，获取当日美妆赛道 TOP 账号，分析其内容策略和数据表现，找到可参考的对标方向。\n2. **品牌方筛选投放达人**：查询 \"上周母婴周榜\"，快速筛选高互动、高增长的母婴赛道达人，节省手动搜集数据的时间。\n3. **MCN 监控竞品动态**：定期查询特定赛道榜单，追踪竞品账号的排名变化和增长趋势，及时调整运营策略。\n4. **行业分析师产出报告**：生成可视化 HTML 报告，一键导出 PDF，用于行业分析汇报或投资决策参考。\n\n---\n\n## 6. 项目架构\n\n### 目录结构\n\n```\nxiaohongshu-top-account/\n├── SKILL.md # 本文件\n├── scripts/\n│ ├── fetch_rank.py # 查询小红书榜单数据\n│ └── generate_report.py # 被 fetch_rank.py --html 调用生成 HTML\n└── references/\n └── api_docs.md # API 详细参数说明\n```\n\n### 技术栈\n\n| 技术 | 用途 |\n| ---- | ---- |\n| Python 标准库 (urllib) | HTTP 请求与数据解析 |\n| 红狐 API | 小红书榜单数据来源 |\n| HTML / CSS | 可视化报告渲染 |\n\n### 核心模块说明\n\n- **fetch_rank.py**：接收用户查询参数（--query 或 --category/--period/--date），自动解析时间、周期和赛道，调用红狐 API 获取榜单数据，支持 --html 参数生成 HTML 报告。\n- **generate_report.py**：读取榜单数据生成 HTML 报告模板，包含排名表格、统计卡片、榜单说明和排名算法。\n\n### 资源索引\n\n| 文件 | 用途 |\n| ---- | ---- |\n| [scripts/fetch_rank.py](scripts/fetch_rank.py) | 查询小红书榜单数据 |\n| [scripts/generate_report.py](scripts/generate_report.py) | 被 fetch_rank.py --html 调用生成 HTML |\n| [references/api_docs.md](references/api_docs.md) | 需要查看 API 详细参数说明时读取 |\n\n---\n\n## 7. 常见问答\n\n### 安装\n\n**Q: 需要安装什么依赖？**\nA: 无需安装第三方依赖，使用 Python 标准库 `urllib` 即可。\n\n**Q: 如何配置 API Key？**\nA: 请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 获取 API KEY，通过环境变量 `REDFOX_API_KEY` 配置。\n\n### 使用\n\n**Q: 日榜什么时候更新？**\nA: 每日 19:00 更新。\n\n**Q: 支持哪些赛道？**\nA: 支持 25 个赛道，完整列表见 references/api_docs.md。\n\n**Q: 赛道关键词匹配不上怎么办？**\nA: 赛道关键词支持 LLM 语义模糊匹配，实在无法识别时降级为 \"综合全部\"。\n\n**Q: 查询不到数据怎么办？**\nA: 部分分类（如体育锻炼）可能返回空数据，脚本会自动回退日期最多 3 天。\n\n### 故障排除\n\n**Q: 最高互动数据为 0？**\nA: 最高互动需要根据点赞 + 评论 + 收藏 + 分享计算，不能直接使用接口返回的 `newInteraction` 字段。\n\n**Q: HTML 报告生成失败？**\nA: 确保 workspace 有写权限，且数据文件路径正确。\n\nFile v1.0.1:README.md\n\n# 小红书热门账号推荐 / xiaohongshu-top-account\n\n---\n\n## 简介\n\n帮你快速发现每日小红书平台最具影响力的账号，掌握赛道动态。\n\n**核心价值**\n基于每日小红书全赛道 TOP50 账号的涨粉、互动、增长趋势数据，帮你解决选题决策、对标账号、竞品监控、赛道选择四大核心问题。\n\n**适用对象**\n\n- 🎬 内容创作者 — 了解同赛道优秀账号表现，寻找对标和学习对象\n- 🏢 品牌方/商务投放 — 高效筛选优质达人，评估合作价值\n- 📦 MCN 机构/内容团队 — 掌握竞品动态，制定运营策略\n- 📊 行业分析师 — 获取数据洞察，生成分析报告\n\n---\n\n## 功能特性\n\n### 核心功能\n\n- **排名查询**：查询小红书账号日榜、周榜、月榜 TOP 50 账号，默认展示 TOP 20\n- **赛道筛选**：支持小红书全站热门、或按 25 个赛道品类精准查询，支持模糊词匹配\n- **综合评分**：根据总粉丝数、新增粉丝、新增点赞/收藏/分享/评论加权计算，多维指标排名客观可信，满分 100 分\n- **HTML 报告生成**：生成带可视化布局的 HTML 文件，账号名可点击跳转小红书主页，支持导出图片或 PDF\n- **订阅推送**：支持设置日榜、周榜、月榜定时自动推送，也可按指定赛道订阅\n\n---\n\n## 密钥获取与安全说明\n\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?souce=github) (`https://redfox.hk`)提供。\n- 请前往 [红狐 hub](https://redfox.hk?souce=github) 注册账号，获取 `REDFOX_API_KEY`。\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\n\n---\n\n## 使用指南\n\n直接用自然语言描述你的需求，无需记忆任何命令格式。\n\n### 常用说法速查\n\n| 意图 | 示例话术 | 效果 |\n| ---------- | -------------------------------------- | ------------------------------- |\n| 查日榜 | \"最新小红书账号日榜排名？\" | 返回全品类最新日榜 TOP 20 |\n| 查赛道周榜 | \"上周小红书美食类账号排行怎么样？\" | 返回美味佳肴赛道最新周榜 TOP 20 |\n| 查月榜 | \"帮我看看上个月美妆类小红书账号的榜单\" | 返回化妆美容赛道最新月榜 TOP 20 |\n| 查完整榜单 | \"我想看完整的 50 条\" | 展示完整 TOP 50 并生成报告 |\n| 下载报告 | \"帮我生成这次榜单的 HTML 报告\" | 生成可视化 HTML 文件并交付 |\n| 订阅推送 | \"我想每天收到美食类小红书日榜更新\" | 创建定时自动推送任务 |\n\n### 输出示例\n\n📊 小红书日榜 · 全品类\n\n数据日期：2026-04-28\n共 50 个账号上榜（展示 TOP 20 条）\n\n💡 榜单说明：数据于每日 19:00 更新昨日数据，与实时数据存在差异\n\n📐 排名算法：根据达人在小红书的总粉丝数、周期内粉丝增量、点赞增量、收藏增量、分享增量以及评论增量加权计算，满分 100\n\n| 排名 | 账号名 | 综合评分 | 总粉丝数 | 新增笔记 | 新增粉丝 | 新增点赞 | 新增评论 | 新增收藏 | 新增分享 |\n| :--: | ---------------- | :------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: |\n| 🥇 1 | 账号名（可点击） | 96 | 254w | 7 | 6919 | 24.6w | 6.7w | 2.5w | 13.4w |\n| 🥈 2 | 账号名（可点击） | 89 | 113w | 1 | 1.9w | 7.9w | 4787 | 2.2w | 3.1w |\n| … | … | … | … | … | … | … | … | … | … |\n\n⚡ 更多操作\n⏺️ 本次榜单完整共 50 条数据，是否需要查看剩余 30 条？\n\n📬 订阅服务\n1️⃣ 是否需要订阅每日/周/月的小红书账号最新排名？\n2️⃣ 是否需要订阅具体赛道的账号表现？\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 示例问法 | 收益 |\n| -------------------- | --------------------- | --------------------------------------------- | ---------------------------------- |\n| 寻找赛道标杆账号 | 内容创作者 / 个体运营 | \"美妆类账号哪些做得好？帮我看看最新日榜\" | 快速找到行业头部，明确内容方向 |\n| 评估达人合作候选人 | 品牌方 / 商务投放 | \"上周小红书穿搭类 TOP50 有哪些账号表现亮眼？\" | 批量筛选，提升投放决策效率 |\n| 监控竞品赛道动态 | MCN 机构 / 内容团队 | \"最近一周美食账号有哪些涨粉最快？\" | 实时掌握竞争格局，快速响应市场变化 |\n| 生成行业分析报告 | 行业分析师 / 咨询顾问 | \"帮我生成 3 月份小红书科技类榜单分析报告\" | 一键生成可视化 HTML，方便汇报分享 |\n| 定期追踪账号排名变化 | 运营团队 | \"我想每周一收到旅行赛道的最新周榜\" | 订阅推送，自动化榜单情报获取 |\n\n---\n\n## 重要数据说明\n\n### 榜单更新时间与数据回溯\n\n| 榜单类型 | 更新时间 | 可回溯范围 |\n| -------- | --------------------------- | ----------- |\n| 日榜 | 每日 19:00 更新昨日数据 | 过去 7 天 |\n| 周榜 | 每周一 15:00 更新上周数据 | 过去 3 周 |\n| 月榜 | 每月 2 号 9:00 更新上月数据 | 过去 3 个月 |\n\n### 支持赛道（25 个）\n\n综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n\n### 综合评分说明\n\n评分根据总粉丝数（20%）、新增粉丝（20%）、新增点赞（15%）、新增收藏（15%）、新增分享（15%）、新增评论（15%）加权计算，满分 100 分。采用对数归一化公式，避免头部账号过度拉分，使中腰部账号排名更具参考性。\n\n### 数据时效\n\n数据非实时更新，账号互动数据为采集时刻的真实数据，与实时数据存在差异。\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n \"slug\": \"xiaohongshu-rank-tracker\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1780393926655\n}\n\nFile v1.0.1:references/api_docs.md\n\n# 小红书榜单 API 接口文档\n\n## 接口基础信息\n\n| 字段 | 值 |\n| ------------ | ------------------------------------------------------ |\n| 接口地址 | `https://redfox.hk/story/api/xhsData/query` |\n| 请求方式 | POST |\n| Content-Type | `application/json` |\n| 认证方式 | `X-API-KEY` Header（从环境变量 `REDFOX_API_KEY` 获取） |\n\n### 鉴权\n\n#### 获取 API Key\n\n请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 获取API KEY\n\n#### 配置 API Key\n\n方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下：\n\n```bash\n{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }\n```\n\n方案2: 终端配置\n\n```bash\nexport REDFOX_API_KEY=\"ak_xxxx...\"\n```\n\n---\n\n## 请求参数（已校验）\n\n```json\n{\n \"dateType\": 1, // 榜单日期类型：1=日榜 2=周榜 3=月榜（必填）\n \"rankDate\": \"2026-04-28\", // 榜单日期 yyyy-MM-dd（必填）\n // 日榜：填当日日期，如 2026-04-28\n // 周榜：填该周**周一**日期，如 2026-04-20\n // 月榜：填该月第一天，如 2026-03-01\n \"type\": \"体育锻炼\", // 赛道分类，默认\"综合全部\"（必填）\n \"source\": \"小红书指数榜-ClawHub\" // 固定值（必填）\n}\n```\n\n### 请求头\n\n| Header | 值 | 说明 |\n| ------------ | ------------------ | -------------------------------------- |\n| Content-Type | `application/json` | 必填 |\n| X-API-KEY | `ak_xxxxxxxx` | 从环境变量 `REDFOX_API_KEY` 获取，必填 |\n\n> ⚠️ **重要**：`source` 必须为 `\"小红书指数榜\"`，使用其他值会导致接口返回空数据！\n>\n> ⚠️ 注意：`page`/`pageSize` 参数无效，接口每次固定返回 50 条数据。\n\n---\n\n## 响应结构（实际返回）\n\n```json\n{\n \"code\": 2000,\n \"data\": [\n {\n \"accountLink\": \"https://www.xiaohongshu.com/user/profile/...\",\n \"accountName\": \"恋与深空\",\n \"accountRanking\": 1,\n \"category\": \"数码科技\",\n \"fansCount\": \"254.06w\",\n \"fansGrowth\": \"6919\",\n \"likedGrowth\": \"24.64w\",\n \"commentsGrowth\": \"6.68w\",\n \"collectedGrowth\": \"2.53w\",\n \"sharedGrowth\": \"13.39w\",\n \"newNoteCount\": null,\n \"dataFetchTime\": \"2026-04-29 19:00:01\",\n \"rankDate\": \"2026-04-28\",\n \"rankPeriod\": \"日榜\"\n }\n ]\n}\n```\n\n> ⚠️ 注意：新接口**不返回** `comprehensiveScore`（综合评分）字段；\n> 互动数各字段均为**字符串格式**，如 `\"6.68w\"`、`\"1245\"`。\n\n---\n\n## 错误码\n\n| code | 含义 |\n| ---- | ---------------------------------------- |\n| 2000 | **成功**（注意：成功码是 2000 不是 0！） |\n| 其他 | 错误，data 为空数组 |\n\n---\n\n## 字段映射（fetch_rank.py normalized JSON）\n\n| 接口原始字段 | normalized 字段 | 含义 |\n| ----------------- | --------------- | ---------- |\n| `accountRanking` | `rank` | 排名 |\n| `accountName` | `accountName` | 账号名 |\n| `category` | `category` | 赛道 |\n| `fansCount` | `followers` | 总粉丝数 |\n| `newNoteCount` | `newNoteCount` | 新增笔记数 |\n| `fansGrowth` | `newFans` | 新增粉丝 |\n| `likedGrowth` | `newLikes` | 新增点赞 |\n| `commentsGrowth` | `newComments` | 新增评论 |\n| `collectedGrowth` | `newCollects` | 新增收藏 |\n| `sharedGrowth` | `newShares` | 新增分享 |\n| `accountLink` | `profileUrl` | 主页链接 |\n\n---\n\n## 可用品类列表\n\n```\n综合全部\n出行代步 / 休闲爱好 / 影视娱乐 / 数码科技 / 医疗保健 / 综合杂项\n星座情感 / 时尚穿搭 / 婚庆婚礼 / 拍摄记录 / 学习教育 / 化妆美容\n居家装修 / 旅行度假 / 亲子育儿 / 个人护理 / 美味佳肴 / 职业发展\n宠物天地 / 潮流鞋包 / 日常生活 / 科学探索 / 新闻资讯 / 体育锻炼\n```\n\n**常用别名映射：**\n| 用户说 | 映射到 |\n|--------|--------|\n| 健身、运动、瑜伽 | 体育锻炼 |\n| 美妆、彩妆、护肤 | 化妆美容/个人护理 |\n| 美食、探店、烹饪 | 美味佳肴 |\n| 旅行、旅游 | 旅行度假 |\n| 母婴、育儿 | 亲子育儿 |\n| 穿搭、时尚 | 时尚穿搭 |\n\n---\n\n## 榜单更新规则\n\n| 榜单类型 | 更新时间 | 统计范围 | rankDate 填写规则 | 示例 |\n| -------- | ---------------- | -------- | ------------------ | ------------ |\n| 日榜 | 每日 19:00 | 前一天 | 填当天日期 | \"2026-04-28\" |\n| 周榜 | 每周一 15:00 | 上周 | 填该周**周一**日期 | \"2026-04-20\" |\n| 月榜 | 每月2号 上午9:00 | 上月 | 填该月**2号** | \"2026-04-02\" |\n\n### 日期回退计算\n\n根据当前时间判断取第几期数据：\n\n| 榜单类型 | 当前时间 < 更新时间 | 当前时间 >= 更新时间 |\n| -------------------- | ------------------- | -------------------- |\n| 日榜 (19:00更新) | offset=2 (前2天) | offset=1 (前1天) |\n| 周榜 (周一15:00更新) | offset=2 (前2周) | offset=1 (前1周) |\n| 月榜 (2号09:00更新) | offset=2 (前2月) | offset=1 (前1月) |\n\n> ⚠️ **月榜必须用每月2号**，实测用月末最后一天（如 \"2026-03-31\"）返回空数据！\n\n> ⚠️ **周榜用周一日期**，实测用周日日期（如 \"2026-04-20\" 周日）会返回空数据！\n\n---\n\n## 常见问题\n\n### 1. 体育锻炼分类数据为空\n\n部分分类（如体育锻炼）在某些日期可能返回空数据。需要自动回退日期尝试：\n\n```\n2026-04-29: 0条 → 回退\n2026-04-28: 50条 ✓\n```\n\n### 2. 互动数据计算\n\n最高互动需要自行计算：\n\n```python\ndef parse_num(s):\n s = str(s).replace('w', '').replace('W', '')\n if '.' in s:\n return float(s) * 10000\n return float(s)\n\ninteraction = parse_num(item['newLikes']) + \\\n parse_num(item['newComments']) + \\\n parse_num(item['newCollects']) + \\\n parse_num(item['newShares'])\n```\n\n> ⚠️ 接口返回的 `newInteraction` 字段值可能为0，不要直接使用！\n\n---\n\n## Python 调用示例\n\n```python\nimport json\nimport os\nfrom urllib.request import Request, urlopen\nfrom urllib.error import URLError, HTTPError\nfrom datetime import date, timedelta\n\nurl = \"https://redfox.hk/story/api/xhsData/query\"\n\n# 从环境变量获取 API Key\napi_key = os.environ.get(\"REDFOX_API_KEY\", \"\")\nif not api_key:\n raise RuntimeError(\"请设置 REDFOX_API_KEY 环境变量\")\n\n# 日榜示例（体育锻炼）\npayload_day = {\n \"dateType\": 1,\n \"rankDate\": \"2026-04-28\",\n \"type\": \"体育锻炼\",\n \"source\": \"小红书指数榜-ClawHub\"\n}\n\n# 周榜示例\npayload_week = {\n \"dateType\": 2,\n \"rankDate\": \"2026-04-20\", # 上周周一\n \"type\": \"综合全部\",\n \"source\": \"小红书指数榜-ClawHub\"\n}\n\n# 月榜示例\npayload_month = {\n \"dateType\": 3,\n \"rankDate\": \"2026-04-02\", # 上月2号\n \"type\": \"综合全部\",\n \"source\": \"小红书指数榜-ClawHub\"\n}\n\npayload_bytes = json.dumps(payload_day).encode(\"utf-8\")\nheaders = {\n \"Content-Type\": \"application/json\",\n \"Accept\": \"application/json\",\n \"X-API-KEY\": api_key,\n}\n\nreq = Request(url, data=payload_bytes, headers=headers, method=\"POST\")\ntry:\n resp = urlopen(req, timeout=15)\n data = json.loads(resp.read().decode(\"utf-8\"))\nexcept HTTPError as e:\n print(f\"HTTP {e.code}: {e.reason}\")\nexcept URLError as e:\n print(f\"网络请求失败: {e.reason}\")\n\nif data[\"code\"] == 2000: # 注意：成功码是 2000\n print(f\"获取到 {len(data['data'])} 条数据\")\n for item in data[\"data\"]:\n print(item[\"accountRanking\"], item[\"accountName\"],\n item[\"fansCount\"], item[\"likedGrowth\"])\nelse:\n print(f\"接口返回错误: {data}\")\n```\n\nFile v1.0.1:references/score_rules.md\n\n# 小红书账号综合评分规则\n\n## 评分维度\n\n综合评分基于以下维度计算：\n\n| 维度 | 权重 | 计算方式 |\n|------|------|----------|\n| 总粉丝数 | 20% | ln(x+1)/ln(max+1) × 100 |\n| 新增粉丝 | 20% | ln(x+1)/ln(max+1) × 100 |\n| 新增点赞 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增收藏 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增分享 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增评论 | 15% | ln(x+1)/ln(max+1) × 100 |\n\n## 计算公式\n\n对数归一化公式：\n```\nscore = ln(x + 1) / ln(max + 1) × 100\n```\n\n其中：\n- `x` 为该账号的当前指标值\n- `max` 为本次榜单中该指标的最大值\n\n## 示例\n\n假设某榜单数据如下：\n\n| 账号 | 新增点赞 | 得分计算 |\n|------|----------|----------|\n| A | 10万 | ln(100001)/ln(100001) × 100 = 100 |\n| B | 5万 | ln(50001)/ln(100001) × 100 ≈ 85 |\n| C | 1万 | ln(10001)/ln(100001) × 100 ≈ 67 |\n\n## 最终得分\n\n各维度加权求和后，保留整数作为综合评分。\n\nFile v1.0.1:README.en.md\n\n# Xiaohongshu Top Account\n\n---\n\n## Introduction\n\nQuickly discover the most influential accounts on Xiaohongshu each day and stay on top of niche trends.\n\n**Core Value**\n\nBased on daily TOP 50 account data across all Xiaohongshu niches — follower growth, engagement, and growth trends — this skill helps you with topic decisions, benchmark accounts, competitor monitoring, and niche selection.\n\n**Who It's For**\n\n- 🎬 Content creators — See how top accounts perform in your niche and find benchmarks to learn from\n- 🏢 Brands / ad buyers — Efficiently screen quality creators and evaluate partnership value\n- 📦 MCN agencies / content teams — Track competitor dynamics and shape operations strategy\n- 📊 Industry analysts — Get data insights and generate analysis reports\n\n---\n\n## Features\n\n### Core Capabilities\n\n- **Ranking queries**: Daily, weekly, and monthly TOP 50 account rankings; TOP 20 shown by default\n- **Niche filtering**: Query across all hot niches on Xiaohongshu or drill into any of 25 track categories with fuzzy keyword matching\n- **Composite score**: Weighted ranking from total followers, new followers, and new likes/saves/shares/comments — objective and credible, scored out of 100\n- **HTML report generation**: Visual HTML reports with clickable account names linking to Xiaohongshu profiles; export as image or PDF\n- **Subscription push**: Schedule daily, weekly, or monthly ranking updates, or subscribe by specific niche\n\n---\n\n## API Key Acquisition & Security\n\n- This skill requires the environment variable: `REDFOX_API_KEY`.\n- `REDFOX_API_KEY` is provided by [RedFoxHub](https://redfox.hk/settings/api-keys?souce=github) (`https://redfox.hk`).\n- Register at [RedFoxHub](https://redfox.hk?souce=github) to obtain your `REDFOX_API_KEY`.\n- Configure `REDFOX_API_KEY` as a device environment variable before using this skill.\n- Before providing your key, confirm its source, available scope, validity period, and whether reset/revocation is supported.\n- Do not hard-code or expose the key in plaintext in code, prompts, logs, or output files.\n\n---\n\n## Usage Guide\n\nDescribe what you need in plain language — no commands to memorize.\n\n### Quick phrase reference\n\n| Intent | Example phrase | What you get |\n| -------------------- | --------------------------------------------------------- | ------------------------------------ |\n| Daily ranking | \"What's the latest Xiaohongshu daily account ranking?\" | Latest all-niche daily TOP 20 |\n| Weekly niche ranking | \"How did food accounts rank on Xiaohongshu last week?\" | Latest 美味佳肴 niche weekly TOP 20 |\n| Monthly ranking | \"Show me last month's beauty Xiaohongshu account ranking\" | Latest 化妆美容 niche monthly TOP 20 |\n| Full ranking | \"I want to see all 50 entries\" | Full TOP 50 with report |\n| Download report | \"Generate an HTML report for this ranking\" | Visual HTML file delivered |\n| Subscribe | \"Send me daily food-niche Xiaohongshu ranking updates\" | Scheduled push task created |\n\n### Sample output\n\n📊 Xiaohongshu Daily Ranking · All niches\n\nData date: 2026-04-28\n50 accounts on the list (showing TOP 20)\n\n💡 Ranking note: Data updates daily at 19:00 with yesterday's figures; may differ from real-time data.\n\n📐 Ranking algorithm: Weighted from total followers, period follower growth, likes, saves, shares, and comments; max score 100\n\n| Rank | Account (clickable) | Score | Total followers | New posts | New followers | New likes | New comments | New saves | New shares |\n| :--: | ------------------- | :---: | :-------------: | :-------: | :-----------: | :-------: | :----------: | :-------: | :--------: |\n| 🥇 1 | Account name | 96 | 2.54M | 7 | 6,919 | 246K | 67K | 25K | 134K |\n| 🥈 2 | Account name | 89 | 1.13M | 1 | 19.1K | 79K | 4,787 | 22K | 31.2K |\n| … | … | … | … | … | … | … | … | … | … |\n\n⚡ More actions\n⏺️ This ranking has 50 entries in total. View the remaining 30?\n\n📬 Subscription\n1️⃣ Subscribe to daily/weekly/monthly Xiaohongshu account ranking updates?\n2️⃣ Subscribe to a specific niche?\n\n---\n\n## Use Cases\n\n| Scenario | Role | Example question | Benefit |\n| ------------------------------- | ----------------------- | ----------------------------------------------------------------- | --------------------------------------------------- |\n| Find niche benchmark accounts | Creator / solo operator | \"Which beauty accounts are doing well? Show me the daily ranking\" | Quickly spot category leaders and clarify direction |\n| Evaluate creator partnerships | Brand / ad buyer | \"Who stood out in last week's Xiaohongshu fashion TOP 50?\" | Batch screening for faster partnership decisions |\n| Monitor competitor niches | MCN / content team | \"Which food accounts gained followers fastest this week?\" | Track competitive landscape and respond quickly |\n| Generate industry reports | Analyst / consultant | \"Generate a March Xiaohongshu tech ranking report for me\" | One-click visual HTML for sharing and presentations |\n| Track ranking changes regularly | Operations team | \"Send me the latest travel weekly ranking every Monday\" | Automated ranking intelligence via subscription |\n\n---\n\n## Important data notes\n\n### Update schedule and lookback\n\n| Ranking type | Update time | Lookback |\n| ------------ | ------------------------------------- | ------------- |\n| Daily | Daily 19:00 — yesterday's data | Past 7 days |\n| Weekly | Monday 15:00 — last week's data | Past 3 weeks |\n| Monthly | 2nd of month 9:00 — last month's data | Past 3 months |\n\n### Supported niches (25)\n\nAll categories, mobility, hobbies, film & entertainment, tech, healthcare, misc, astrology & emotions, fashion, weddings, photography, education, beauty, home decor, travel, parenting, personal care, food, career, pets, bags & shoes, daily life, science, news, sports & fitness\n\n### Composite score notes\n\nScore is weighted: total followers (20%), new followers (20%), new likes (15%), new saves (15%), new shares (15%), new comments (15%); max 100. Uses log normalization to avoid top accounts dominating scores, making mid-tier rankings more reference-worthy.\n\n### Data freshness\n\nData is not real-time. Engagement figures reflect the collection moment and may differ from live platform data.\n\n---\n\nFile v1.0.1:skill-card.md\n\n## Description:
\n小红书账号榜单追踪分析工具，支持查询日榜、周榜、月榜 TOP50 排名和热门账号。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[redfox-data](https://clawhub.ai/user/redfox-data)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nContent creators, brands, MCN teams, and analysts use this skill to query Xiaohongshu account rankings, filter by niche, generate ranking reports, and optionally schedule ranking updates.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires REDFOX_API_KEY and sends authenticated requests to RedFox's Xiaohongshu ranking API.
\nMitigation: Install only if you trust RedFox with the key, keep the key in the environment, and avoid exposing it in prompts, logs, or output files.
\nRisk: The skill can create recurring ranking reminders when the user asks for subscriptions.
\nMitigation: Review each subscription before confirming it and cancel recurring reminders when automated ranking pushes are no longer wanted.
\nRisk: Generated HTML reports are local files and may load a CDN script when opened for image export.
\nMitigation: Open generated reports only in an environment where loading that external script is acceptable.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/redfox-data/xiaohongshu-rank-tracker)
\n- [RedFox publisher profile](https://clawhub.ai/user/redfox-data)
\n- [API documentation](artifact/references/api_docs.md)
\n- [Score rules](artifact/references/score_rules.md)
\n- [RedFox API key settings](https://redfox.hk/settings/api-keys?source=clawhub)
\n\n\n## Skill Output:
\n**Output Type(s):** [Markdown, Files, Shell commands, API Calls, Configuration instructions, Guidance]
\n**Output Format:** [Markdown ranking tables, local HTML reports, and concise setup or subscription guidance]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires REDFOX_API_KEY for ranking API calls; HTML reports are local workspace files.]
\n\n## Skill Version(s):
\n1.0.1 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.0: 7 files, 30116 bytes\n\nFiles: references/api_docs.md (6603b), references/score_rules.md (989b), scripts/fetch_rank.py (37980b), scripts/generate_report.py (20262b), skill-card.md (2383b), SKILL.md (15686b), _meta.json (143b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: xiaohongshu-rank-tracker\ndescription: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号\ndependency:\n python:\n - requests>=2.28.0\n---\n\n# 小红书全品类账号榜单 Skill\n\n## 概述\n\n本 Skill 基于 `https://redfox.hk/story/api/xhsData/query` 数据接口，\n提供小红书全品类/分品类账号每日/每周/每月的表现榜单查询。支持三大核心能力：\n\n1. **排名查询** — 查日榜、周榜、月榜 TOP50\n2. **领域查询** — 按品类筛选（美妆、美食、旅行、母婴、健身/体育锻炼等）\n3. **报告下载** — 生成 HTML 可视化报告，支持导出 PDF/截图\n4. **定时订阅** — 设置自动化定时推送\n\n---\n\n## 触发词与意图识别\n\n| 用户意图 | 典型触发词 | 对应操作 |\n| -------- | --------------------------------------------------------- | ----------------------------- |\n| 排名查询 | 小红书日榜、周榜、月榜、TOP50、最夯账号、排行榜、最新推荐 | 调用 API 并格式化输出 |\n| 领域查询 | 美妆类/美食类/旅行类/母婴类/健身类...小红书排名 | 调用 API 并按 category 筛选 |\n| 报告下载 | 下载报告、导出榜单、生成报告 | 使用 --html 参数自动生成 HTML |\n| 定时订阅 | 订阅日榜/周榜/月榜、定时推送、每天发给我 | 创建 WorkBuddy Automation |\n\n---\n\n## 执行流程\n\n### 严格输出顺序（必须按顺序执行，不得跳过）\n\n**第一步：内容输出**\n\n1. 调用脚本查询榜单数据（默认只查20条）：\n ```bash\n python scripts/fetch_rank.py --query \"用户原始问题\" --limit 20 --html\n ```\n2. 按标准模板格式化输出榜单数据（Markdown 表格形式，最多20条）\n\n**第二步：询问定时订阅**\n\n- 输出完榜单数据后，**直接**追加以下询问（不等待用户回复）：\n ```\n 📬 订阅服务\n 1️⃣ 是否需要订阅每日/周/月的小红书账号最新排名，订阅后定时推送给您？\n 2️⃣ 是否需要订阅具体赛道的账号表现？我们支持：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n ```\n\n**第三步：交付 HTML 报告**\n\n- 脚本已自动生成HTML文件，使用 deliver_attachments 工具交付脚本输出的 HTML 文件路径\n- 追加以下内容：\n ```\n ⚡ 更多操作\n • 点击下方下载HTML报告文件，可在浏览器中打开查看，支持一键导出PDF/高清图片\n • 本次榜单完整共50条数据，是否需要查看全部？\n ```\n\n**用户表示需要查看全部数据时：**\n\n> ⚠️ **强制要求**：必须同时输出 Markdown 表格和交付 HTML 报告，两者缺一不可。\n\n1. 重新调用脚本获取完整50条数据：\n ```bash\n python scripts/fetch_rank.py --query \"用户原始问题\" --limit 50 --html\n ```\n2. 在对话中输出完整50条数据的 Markdown 表格（按标准模板格式）\n3. **必须使用 deliver_attachments 交付 HTML 文件**（关键步骤，不可遗漏），告知用户\"以下是完整50条数据的 HTML 报告，可直接点击下载查看\"\n\n---\n\n### 流程一：排名查询（推荐：自然语言模式）\n\n**直接传入用户原始问题**，脚本自动完成全部解析：\n\n```bash\npython scripts/fetch_rank.py --query \"用户原始问题\" --limit 20 --html\n```\n\n**自动解析逻辑：**\n\n#### ① 时间判断与日期计算\n\n根据当前时间判断最新数据是否已更新：\n\n| 榜单类型 | 更新时间 | 当前时间 < 更新时间 | 当前时间 >= 更新时间 |\n| -------- | ---------------- | ------------------- | -------------------- |\n| 日榜 | 每日 19:00 | 取前2天 (offset=2) | 取前一天 (offset=1) |\n| 周榜 | 每周一 15:00 | 取前2周 (offset=2) | 取前1周 (offset=1) |\n| 月榜 | 每月2号 上午9:00 | 取前2月 (offset=2) | 取前1月 (offset=1) |\n\n**日期计算公式：**\n\n- 日榜：`date.today() - timedelta(days=offset)`\n- 周榜：`date.today() - timedelta(weeks=offset)` 后的最近周一\n- 月榜：`date.today() - timedelta(days=30*offset)` 后的每月2号\n\n**更新规则（输出时告知用户）：**\n\n- 日榜：每日 **19:00** 更新\n- 周榜：每周一 **15:00** 更新\n- 月榜：每月 **2号 9:00** 更新\n\n#### ② 周期判断\n\n自动从用户文本中识别日/周/月（无明确则默认**日榜**）：\n\n- 含\"周\"/\"周榜\"→ `week`\n- 含\"月\"/\"月榜\"→ `month`\n- 其余默认 → `day`\n\n#### ③ 回溯范围校验\n\n| 榜单类型 | 最大回溯 | 超范围处理 |\n| -------- | -------- | ---------------------- |\n| 日榜 | 近7天 | 自动切换至最近可用日期 |\n| 周榜 | 近3周 | 自动切换至最近可用日期 |\n| 月榜 | 近3个月 | 自动切换至最近可用日期 |\n\n**超出范围时**：-若用户查询当日及未来日期的榜单，在榜单说明输出中增加：「非常抱歉🙏，我们最新的是昨日/上周/上月的数据，将为您提供最接近您需求的昨日/上周/上月热榜。」-若用户查询时间早于回溯日期，在榜单说明输出中增加回复：「非常抱歉🙏，目前榜单最多支持回溯「过去7天/过去3周/过去3月」，我将为您查询最接近您需求的时间范围~」\n\n#### ④ 赛道（type）匹配\n\n支持模糊匹配，映射表见 `references/api_docs.md`。\n\n**常用映射：**\n| 用户说 | 映射到 |\n|--------|--------|\n| 健身、运动、瑜伽 | 体育锻炼 |\n| 美妆、彩妆、护肤 | 化妆美容/个人护理 |\n| 美食、探店、烹饪 | 美味佳肴 |\n| 旅行、旅游 | 旅行度假 |\n| 母婴、育儿 | 亲子育儿 |\n| 穿搭、时尚 | 时尚穿搭 |\n\n若无法匹配，输出综合全部，并告知用户无法识别的赛道类别。\n\n#### ⑤ 数据回退机制\n\n**重要**：部分分类（如体育锻炼）在某些日期可能返回空数据。此时应：\n\n1. 自动尝试前一个日期\n2. 最多回退3天\n3. 若仍无数据，告知用户该分类在该时间段暂无数据\n\n---\n\n### 流程二：报告下载\n\n1. 查询时加 `--html --limit 50` 参数，脚本会自动生成HTML报告\n2. 调用 `deliver_attachments` 交付 HTML 文件（账号名均可点击跳转小红书主页）\n\n---\n\n### 流程三：定时订阅\n\n1. 询问订阅周期（每日 / 每周 / 每月）。\n2. 使用 `automation_update` 创建自动化任务：\n - 每日订阅：`FREQ=DAILY;BYHOUR=8;BYMINUTE=0`\n - 每周订阅：`FREQ=WEEKLY;BYDAY=MO;BYHOUR=8;BYMINUTE=0`\n - 每月订阅：`FREQ=WEEKLY;BYDAY=MO;BYHOUR=8;BYMINUTE=0;INTERVAL=4`\n3. automation prompt：`查询小红书最新{period}榜（综合全部）并推送给用户`\n\n---\n\n## 标准输出模板\n\n**必须按以下顺序输出，不得跳过任何步骤：**\n\n### 第一步：内容输出\n\n```\n📊 小红书{period_label} · {category_label}\n\n数据日期：{date}\n共 {total} 个账号上榜\n\n💡 榜单说明：{period_update_time}更新昨日/上周/上月数据。\n\n📐 排名算法：排名根据达人在小红书的**总粉丝数**、周期内的**粉丝增量**、**点赞增量**、**收藏增量**、**分享增量**以及**评论增量**加权计算所得，满分100分。\n\n| 排名 | 账号名 | 综合评分 | 总粉丝数 | 新增笔记 | 新增粉丝 | 新增点赞 | 新增评论 | 新增收藏 | 新增分享 |\n|:---:|--------|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|\n| 🥇 1 | 账号A · 赛道 | 96 | 254.06w | 7 | 6919 | 24.64w | 6.68w | 2.53w | 13.39w |\n| 🥈 2 | 账号B · 赛道 | 89 | 113.55w | 1 | 1.91w | 7.90w | 4787 | 2.18w | 3.12w |\n| 🥉 3 | 账号C · 赛道 | 87 | 439.14w | 2 | 5859 | 16.51w | 993 | 7688 | 687 |\n| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |\n\n统计概览：上榜账号 {total} · 最高互动 {max_interaction} · 总新增笔记 {total_notes}\n\n```\n\n### 第二步：询问定时订阅（直接追加，不等待回复）\n\n```\n📬 订阅服务\n1️⃣ 是否需要订阅每日/周/月的小红书账号最新排名，订阅后定时推送给您？\n2️⃣ 是否需要订阅具体赛道的账号表现？我们支持：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n```\n\n**用户回复\"需要订阅\"时**，使用 `calendar_create` 工具创建日程：\n\n- 参数：\n - `title`: 小红书{period_label}榜单推送\n - `description`: 订阅小红书{period_label}榜单，自动查询并推送最新排名数据\n - `start_time`: 根据订阅周期计算（每日08:00/每周一08:00/每月2号08:00）\n - `end_time`: start_time 后1小时\n - `reminder`: 0（不需要提醒）\n- 创建成功后告知用户日程已创建\n\n### 第三步：交付 HTML 报告（必须交付）\n\n> ⚠️ **强制要求**：必须立即使用 deliver_attachments 交付文件，不得仅提示用户下载而不实际交付。\n\n- 脚本已自动生成HTML文件（路径在输出末尾）\n- **必须使用 deliver_attachments 交付 HTML 文件**（这是关键步骤，遗漏将导致用户看不到报告）\n- 交付后追加以下提示：\n\n```\n⚡ 更多操作\n• 点击下方下载HTML报告文件，可在浏览器中打开查看，支持一键导出PDF/高清图片\n• 本次榜单完整共50条数据，是否需要查看全部？\n```\n\n> ⚠️ **字段说明**：\n>\n> - **最高互动**：互动总数 = 点赞 + 评论 + 收藏 + 分享，取榜单中互动最高的账号\n> - 当前接口仅返回各细分字段（总粉丝数、新增粉丝、新增点赞、新增评论、新增收藏、新增分享）\n> - 赛道展示在账号名下方，使用 \"账号名 · 赛道\" 格式\n\n---\n\n## HTML 报告模板规范\n\n### 表格列规范\n\n| 列名 | 说明 |\n| -------- | ------------------------------------------ |\n| 排名 | 1-3名使用金银铜牌样式，其余使用灰色徽章 |\n| 账号名 | 可点击跳转小红书主页，赛道展示在账号名下方 |\n| 总粉丝数 | 格式：254.06w |\n| 新增笔记 | 整数 |\n| 新增粉丝 | 整数或带 w 单位 |\n| 新增点赞 | 带 w 单位 |\n| 新增评论 | 整数或带 w 单位 |\n| 新增收藏 | 整数或带 w 单位 |\n| 新增分享 | 整数或带 w 单位 |\n\n**注意**：不展示综合评分列，表格从11列减少到9列。\n\n### 统计卡片规范\n\n| 指标 | 说明 |\n| ---------- | ------------------------------------ |\n| 上榜账号 | 榜单总数，默认50 |\n| 最高互动 | 互动总数 = 点赞 + 评论 + 收藏 + 分享 |\n| 总新增笔记 | 所有账号新增笔记之和 |\n\n### 榜单说明与排名算法\n\n```html\n
\n
\n 💡 榜单说明：{period_update_desc}更新，与实时数据存在差异。\n
\n
\n 📐 排名算法：排名根据达人在小红书的\n 总粉丝数、周期内的\n 粉丝增量、点赞增量、收藏增量、分享增量\n 以及 评论增量 加权计算所得。\n
\n
\n```\n\n---\n\n## API 参数说明\n\n### 接口信息\n\n- **URL**：`POST https://redfox.hk/story/api/xhsData/query`\n- **成功码**：`code: 2000`（非0！）\n\n### 请求参数\n\n| 参数名 | 类型 | 说明 | 示例 |\n| -------- | ------ | -------------------------------- | -------------- |\n| dateType | int | 榜单类型：1=日榜, 2=周榜, 3=月榜 | 1 |\n| rankDate | string | 日期（格式：YYYY-MM-DD） | \"2026-04-28\" |\n| type | string | 赛道名称（中文） | \"体育锻炼\" |\n| source | string | **必须为** `小红书指数榜` | \"小红书指数榜\" |\n\n### 各榜单日期参数\n\n| 榜单类型 | rankDate 格式 | 示例 | offset计算 |\n| -------- | ---------------------------- | ---------------- | ------------------------------------------ |\n| 日榜 | YYYY-MM-DD（前一天或前两天） | \"2026-04-28\" | 当前时间<19:00→offset=2, ≥19:00→offset=1 |\n| 周榜 | YYYY-MM-DD（周一） | \"2026-04-20\" | 当前时间周一<15:00→offset=2, 否则→offset=1 |\n| **月榜** | **YYYY-MM-02（每月2号）** | **\"2026-04-02\"** | 当前时间2号<09:00→offset=2, 否则→offset=1 |\n\n### 返回字段\n\n| 字段 | 说明 |\n| ------------ | -------------- |\n| accountName | 账号名 |\n| category | 赛道分类 |\n| followers | 总粉丝数 |\n| newNoteCount | 新增笔记数 |\n| newFans | 新增粉丝 |\n| newLikes | 新增点赞 |\n| newComments | 新增评论 |\n| newCollects | 新增收藏 |\n| newShares | 新增分享 |\n| profileUrl | 小红书主页链接 |\n\n---\n\n## 环境准备\n\n```bash\npip install requests\n```\n\n---\n\n## 使用示例\n\n### 示例1：查询美妆类日榜\n\n- 场景/输入：用户说\"小红书美妆日榜\"\n- 预期产出：返回美妆类当日 TOP20 榜单数据\n- 关键要点：自动解析赛道为\"化妆美容\"，日期自动计算为最新可用日期\n\n### 示例2：查询美食类周榜\n\n- 场景/输入：用户说\"最新美食周榜\"\n- 预期产出：返回美食类上周榜单\n- 关键要点：自动解析周期为 week，赛道为\"美味佳肴\"\n\n### 示例3：生成 HTML 报告\n\n- 场景/输入：用户需要导出完整报告\n- 预期产出：生成可下载的 HTML 文件\n- 关键要点：调用 fetch_rank.py 时加 --html 参数自动生成HTML报告\n\n---\n\n## 资源索引\n\n- 脚本:见 [scripts/fetch_rank.py](scripts/fetch_rank.py)(用途:查询小红书榜单数据)\n- 脚本:见 [scripts/generate_report.py](scripts/generate_report.py)(用途:被 fetch_rank.py --html 调用生成 HTML)\n- 参考:见 [references/api_docs.md](references/api_docs.md)(何时读取:需要查看 API 详细参数说明时)\n\n---\n\n## 注意事项\n\n- 日榜默认展示 TOP 20，完整 50 条通过报告或追问查看。\n- 赛道关键词支持 LLM 语义模糊匹配，实在无法识别时降级为综合全部。\n- HTML 报告账号名均可点击跳转小红书主页（基于 `profileUrl` 字段）。\n- 生成报告前确保 workspace 有写权限。\n- **最高互动**需要根据点赞+评论+收藏+分享计算，不能直接使用接口返回的 `newInteraction` 字段（该字段值可能为0）。\n- **月榜日期参数必须使用每月2号**，如查询上月榜单用 \"2026-04-02\"。\n- **体育锻炼分类**：部分日期可能返回空数据，需要自动回退日期。\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n \"slug\": \"xiaohongshu-rank-tracker\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1779271059215\n}\n\nFile v1.0.0:references/api_docs.md\n\n# 小红书榜单 API 接口文档\n\n## 接口基础信息\n\n| 字段 | 值 |\n| ------------ | ------------------------------------------- |\n| 接口地址 | `https://redfox.hk/story/api/xhsData/query` |\n| 请求方式 | POST |\n| Content-Type | `application/json` |\n| 认证方式 | 无（公开接口） |\n\n---\n\n## 请求参数（已校验）\n\n```json\n{\n \"dateType\": 1, // 榜单日期类型：1=日榜 2=周榜 3=月榜（必填）\n \"rankDate\": \"2026-04-28\", // 榜单日期 yyyy-MM-dd（必填）\n // 日榜：填当日日期，如 2026-04-28\n // 周榜：填该周**周一**日期，如 2026-04-20\n // 月榜：填该月第一天，如 2026-03-01\n \"type\": \"体育锻炼\", // 赛道分类，默认\"综合全部\"（必填）\n \"source\": \"小红书指数榜\" // 固定值（必填）\n}\n```\n\n> ⚠️ **重要**：`source` 必须为 `\"小红书指数榜\"`，使用其他值会导致接口返回空数据！\n>\n> ⚠️ 注意：`page`/`pageSize` 参数无效，接口每次固定返回 50 条数据。\n\n---\n\n## 响应结构（实际返回）\n\n```json\n{\n \"code\": 2000,\n \"data\": [\n {\n \"accountLink\": \"https://www.xiaohongshu.com/user/profile/...\",\n \"accountName\": \"恋与深空\",\n \"accountRanking\": 1,\n \"category\": \"数码科技\",\n \"fansCount\": \"254.06w\",\n \"fansGrowth\": \"6919\",\n \"likedGrowth\": \"24.64w\",\n \"commentsGrowth\": \"6.68w\",\n \"collectedGrowth\": \"2.53w\",\n \"sharedGrowth\": \"13.39w\",\n \"newNoteCount\": null,\n \"dataFetchTime\": \"2026-04-29 19:00:01\",\n \"rankDate\": \"2026-04-28\",\n \"rankPeriod\": \"日榜\"\n }\n ]\n}\n```\n\n> ⚠️ 注意：新接口**不返回** `comprehensiveScore`（综合评分）字段；\n> 互动数各字段均为**字符串格式**，如 `\"6.68w\"`、`\"1245\"`。\n\n---\n\n## 错误码\n\n| code | 含义 |\n| ---- | ---------------------------------------- |\n| 2000 | **成功**（注意：成功码是 2000 不是 0！） |\n| 其他 | 错误，data 为空数组 |\n\n---\n\n## 字段映射（fetch_rank.py normalized JSON）\n\n| 接口原始字段 | normalized 字段 | 含义 |\n| ----------------- | --------------- | ---------- |\n| `accountRanking` | `rank` | 排名 |\n| `accountName` | `accountName` | 账号名 |\n| `category` | `category` | 赛道 |\n| `fansCount` | `followers` | 总粉丝数 |\n| `newNoteCount` | `newNoteCount` | 新增笔记数 |\n| `fansGrowth` | `newFans` | 新增粉丝 |\n| `likedGrowth` | `newLikes` | 新增点赞 |\n| `commentsGrowth` | `newComments` | 新增评论 |\n| `collectedGrowth` | `newCollects` | 新增收藏 |\n| `sharedGrowth` | `newShares` | 新增分享 |\n| `accountLink` | `profileUrl` | 主页链接 |\n\n---\n\n## 可用品类列表\n\n```\n综合全部\n出行代步 / 休闲爱好 / 影视娱乐 / 数码科技 / 医疗保健 / 综合杂项\n星座情感 / 时尚穿搭 / 婚庆婚礼 / 拍摄记录 / 学习教育 / 化妆美容\n居家装修 / 旅行度假 / 亲子育儿 / 个人护理 / 美味佳肴 / 职业发展\n宠物天地 / 潮流鞋包 / 日常生活 / 科学探索 / 新闻资讯 / 体育锻炼\n```\n\n**常用别名映射：**\n| 用户说 | 映射到 |\n|--------|--------|\n| 健身、运动、瑜伽 | 体育锻炼 |\n| 美妆、彩妆、护肤 | 化妆美容/个人护理 |\n| 美食、探店、烹饪 | 美味佳肴 |\n| 旅行、旅游 | 旅行度假 |\n| 母婴、育儿 | 亲子育儿 |\n| 穿搭、时尚 | 时尚穿搭 |\n\n---\n\n## 榜单更新规则\n\n| 榜单类型 | 更新时间 | 统计范围 | rankDate 填写规则 | 示例 |\n| -------- | ---------------- | -------- | ------------------ | ------------ |\n| 日榜 | 每日 19:00 | 前一天 | 填当天日期 | \"2026-04-28\" |\n| 周榜 | 每周一 15:00 | 上周 | 填该周**周一**日期 | \"2026-04-20\" |\n| 月榜 | 每月2号 上午9:00 | 上月 | 填该月**2号** | \"2026-04-02\" |\n\n### 日期回退计算\n\n根据当前时间判断取第几期数据：\n\n| 榜单类型 | 当前时间 < 更新时间 | 当前时间 >= 更新时间 |\n| -------------------- | ------------------- | -------------------- |\n| 日榜 (19:00更新) | offset=2 (前2天) | offset=1 (前1天) |\n| 周榜 (周一15:00更新) | offset=2 (前2周) | offset=1 (前1周) |\n| 月榜 (2号09:00更新) | offset=2 (前2月) | offset=1 (前1月) |\n\n> ⚠️ **月榜必须用每月2号**，实测用月末最后一天（如 \"2026-03-31\"）返回空数据！\n\n> ⚠️ **周榜用周一日期**，实测用周日日期（如 \"2026-04-20\" 周日）会返回空数据！\n\n---\n\n## 常见问题\n\n### 1. 体育锻炼分类数据为空\n\n部分分类（如体育锻炼）在某些日期可能返回空数据。需要自动回退日期尝试：\n\n```\n2026-04-29: 0条 → 回退\n2026-04-28: 50条 ✓\n```\n\n### 2. 互动数据计算\n\n最高互动需要自行计算：\n\n```python\ndef parse_num(s):\n s = str(s).replace('w', '').replace('W', '')\n if '.' in s:\n return float(s) * 10000\n return float(s)\n\ninteraction = parse_num(item['newLikes']) + \\\n parse_num(item['newComments']) + \\\n parse_num(item['newCollects']) + \\\n parse_num(item['newShares'])\n```\n\n> ⚠️ 接口返回的 `newInteraction` 字段值可能为0，不要直接使用！\n\n---\n\n## Python 调用示例\n\n```python\nimport requests\nfrom datetime import date, timedelta\n\nurl = \"https://redfox.hk/story/api/xhsData/query\"\n\n# 日榜示例（体育锻炼）\npayload_day = {\n \"dateType\": 1,\n \"rankDate\": \"2026-04-28\",\n \"type\": \"体育锻炼\",\n \"source\": \"小红书指数榜\"\n}\n\n# 周榜示例\npayload_week = {\n \"dateType\": 2,\n \"rankDate\": \"2026-04-20\", # 上周周一\n \"type\": \"综合全部\",\n \"source\": \"小红书指数榜\"\n}\n\n# 月榜示例\npayload_month = {\n \"dateType\": 3,\n \"rankDate\": \"2026-04-02\", # 上月2号\n \"type\": \"综合全部\",\n \"source\": \"小红书指数榜\"\n}\n\nresp = requests.post(url, json=payload_day, timeout=15)\ndata = resp.json()\n\nif data[\"code\"] == 2000: # 注意：成功码是 2000\n print(f\"获取到 {len(data['data'])} 条数据\")\n for item in data[\"data\"]:\n print(item[\"accountRanking\"], item[\"accountName\"],\n item[\"fansCount\"], item[\"likedGrowth\"])\nelse:\n print(f\"接口返回错误: {data}\")\n```\n\nFile v1.0.0:references/score_rules.md\n\n# 小红书账号综合评分规则\n\n## 评分维度\n\n综合评分基于以下维度计算：\n\n| 维度 | 权重 | 计算方式 |\n|------|------|----------|\n| 总粉丝数 | 20% | ln(x+1)/ln(max+1) × 100 |\n| 新增粉丝 | 20% | ln(x+1)/ln(max+1) × 100 |\n| 新增点赞 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增收藏 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增分享 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增评论 | 15% | ln(x+1)/ln(max+1) × 100 |\n\n## 计算公式\n\n对数归一化公式：\n```\nscore = ln(x + 1) / ln(max + 1) × 100\n```\n\n其中：\n- `x` 为该账号的当前指标值\n- `max` 为本次榜单中该指标的最大值\n\n## 示例\n\n假设某榜单数据如下：\n\n| 账号 | 新增点赞 | 得分计算 |\n|------|----------|----------|\n| A | 10万 | ln(100001)/ln(100001) × 100 = 100 |\n| B | 5万 | ln(50001)/ln(100001) × 100 ≈ 85 |\n| C | 1万 | ln(10001)/ln(100001) × 100 ≈ 67 |\n\n## 最终得分\n\n各维度加权求和后，保留整数作为综合评分。\n\nFile v1.0.0:skill-card.md\n\n## Description:
\nTracks Xiaohongshu account rankings and helps agents query daily, weekly, and monthly Top 50 lists with HTML report generation.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[redfox-data](https://clawhub.ai/user/redfox-data)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nMarketing, social media, and creator analytics users use this skill to query Xiaohongshu account leaderboards by period and category. It returns ranked Markdown summaries, generates downloadable HTML reports, and can help set up recurring ranking updates when the user asks.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill contacts redfox.hk to retrieve ranking data.
\nMitigation: Install and run it only when use of the RedFox ranking API is acceptable for the workspace and user request.
\nRisk: The skill writes HTML reports in the workspace.
\nMitigation: Review generated report files before sharing or opening them outside the intended workflow.
\nRisk: Release security evidence notes an unused insecure TLS helper.
\nMitigation: Keep normal HTTPS certificate verification in use and remove the unused helper before future reuse or maintenance.
\n\n\n## Reference(s):
\n- [Skill page](https://clawhub.ai/redfox-data/xiaohongshu-rank-tracker)
\n- [Xiaohongshu ranking API documentation](references/api_docs.md)
\n- [Xiaohongshu account scoring rules](references/score_rules.md)
\n- [RedFox Xiaohongshu ranking API](https://redfox.hk/story/api/xhsData/query)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, files, configuration, guidance]
\n**Output Format:** [Markdown ranking tables, shell command invocations, and generated HTML report files]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May write HTML reports in the workspace and may request a recurring subscription or calendar item only when the user asks.]
\n\n## Skill Version(s):
\n1.0.0 (source: release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
","readmeExcerpt":"Skill: 小红书热门账号推荐 Owner: redfox-data Summary: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Tags: latest:1.0.2 Version history: v1.0.2 | 2026-07-28T05:43:18.511Z | user xiaohongshu-rank-tracker 1.0.2 更新日志 - 移除了 skill-card.md 说明文件，无其他功能或逻辑变更。 - 文档简化和部分描述调整，保持 Skill 主体功能不变。 v1.0.1 | 2026-06-02T09:52:06.655Z | user xiaohongshu-rank-tracker v1.0.1 - Renamed skill: now called \"xiaohongshu-top-account\" to better reflect the function","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }"},{"language":"bash","snippet":"export REDFOX_API_KEY=\"ak_xxxx...\""},{"language":"bash","snippet":"python scripts/fetch_rank.py --query \"用户原始问题\" --limit 20 --html"},{"language":"text","snippet":"📬 订阅服务\n 1️⃣ 是否需要订阅每日/周/月的小红书账号最新排名，订阅后定时推送给您？\n2️⃣ 是否需要订阅具体赛道的账号表现？我们支持：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n\n**第三步：交付 HTML 报告**\n- 脚本已自动生成HTML文件，使用 deliver_attachments 工具交付脚本输出的 HTML 文件路径\n- 追加以下内容："},{"language":"text","snippet":"**用户表示需要查看全部数据时：**\n\n> ⚠️ **强制要求**：必须同时输出 Markdown 表格和交付 HTML 报告，两者缺一不可。\n\n1. 重新调用脚本获取完整50条数据："},{"language":"text","snippet":"2. 在对话中输出完整50条数据的 Markdown 表格（按标准模板格式）\n3. **必须使用 deliver_attachments 交付 HTML 文件**（关键步骤，不可遗漏），告知用户\"以下是完整50条数据的 HTML 报告，可直接点击下载查看\"\n\n---\n\n### 流程一：排名查询（推荐：自然语言模式）\n\n**直接传入用户原始问题**，脚本自动完成全部解析："}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: xiaohongshu-top-account\ndescription: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号\n---\n\n# 小红书热门账号推荐\n\n## 概述\n\n本 Skill 基于 `https://redfox.hk/story/api/xhsData/query` 数据接口，\n提供小红书全品类/分品类账号每日/每周/每月的表现榜单查询。支持三大核心能力：\n1. **排名查询** — 查日榜、周榜、月榜 TOP50\n2. **领域查询** — 按品类筛选（美妆、美食、旅行、母婴、健身/体育锻炼等）\n3. **报告下载** — 生成 HTML 可视化报告，支持导出 PDF/截图\n4. **定时订阅** — 设置自动化定时推送\n\n---\n\n## 鉴权\n\n#### 获取 API Key\n\n请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 获取API KEY\n\n#### 配置 API Key\n\n方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中\n\n```bash\n{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }\n```\n\n方案2: 终端配置：export REDFOX_API_KEY=\"ak_xxxx...\"\n\n```bash\nexport REDFOX_API_KEY=\"ak_xxxx...\"\n```\n\n---\n\n## 触发词与意图识别\n\n| 用户意图 | 典型触发词 | 对应操作 |\n|---|---|---|\n| 排名查询 | 小红书日榜、周榜、月榜、TOP50、最夯账号、排行榜、最新推荐 | 调用 API 并格式化输出 |\n| 领域查询 | 美妆类/美食类/旅行类/母婴类/健身类...小红书排名 | 调用 API 并按 category 筛选 |\n| 报告下载 | 下载报告、导出榜单、生成报告 | 使用 --html 参数自动生成 HTML |\n| 定时订阅 | 订阅日榜/周榜/月榜、定时推送、每天发给我 | 创建 WorkBuddy Automation |\n\n---\n\n## 执行流程\n\n### 严格输出顺序（必须按顺序执行，不得跳过）\n\n**第一步：内容输出**\n1. 调用脚本查询榜单数据（默认只查20条）：\n ```bash\n python scripts/fetch_rank.py --query \"用户原始问题\" --limit 20 --html\n ```\n2. 按标准模板格式化输出榜单数据（Markdown 表格形式，最多20条）\n\n**第二步：询问定时订阅**\n- 输出完榜单数据后，**直接**追加以下询问（不等待用户回复）：\n ```\n 📬 订阅服务\n 1️⃣ 是否需要订阅每日/周/月的小红书账号最新排名，订阅后定时推送给您？\n2️⃣ 是否需要订阅具体赛道的账号表现？我们支持：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n\n**第三步：交付 HTML 报告**\n- 脚本已自动生成HTML文件，使用 deliver_attachments 工具交付脚本输出的 HTML 文件路径\n- 追加以下内容：\n ```\n ⚡ 更多操作\n • 点击下方下载HTML报告文件，可在浏览器中打开查看，支持一键导出PDF/高清图片\n • 本次榜单完整共50条数据，是否需要查看全部？\n ```\n\n**用户表示需要查看全部数据时：**\n\n> ⚠️ **强制要求**：必须同时输出 Markdown 表格和交付 HTML 报告，两者缺一不可。\n\n1. 重新调用脚本获取完整50条数据：\n ```bash\n python scripts/fetch_rank.py --query \"用户原始问题\" --limit 50 --html\n ```\n2. 在对话中输出完整50条数据的 Markdown 表格（按标准模板格式）\n3. **必须使用 deliver_attachments 交付 HTML 文件**（关键步骤，不可遗漏），告知用户\"以下是完整50条数据的 HTML 报告，可直接点击下载查看\"\n\n---\n\n### 流程一：排名查询（推荐：自然语言模式）\n\n**直接传入用户原始问题**，脚本自动完成全部解析：\n```bash\npython scripts/fetch_rank.py --query \"用户原始问题\" --limit 20 --html\n```\n\n**自动解析逻辑：**\n\n#### ① 时间判断与日期计算\n\n根据当前时间判断最新数据是否已更新：\n\n| 榜单类型 | 更新时间 | 当前时间 < 更新时间 | 当前时间 >= 更新时间 |\n|---------|---------|-------------------|-------------------|\n| 日榜 | 每日 19:00 | 取前2天 (offset=2) | 取前一天 (offset=1) |\n| 周榜 | 每周一 15:00 | 取前2周 (offset=2) | 取前1周 (offset=1) |\n| 月榜 | 每月1日 上午9:00 | 取前2月 (offset=2) | 取前1月 (offset=1) |\n\n**日期计算公式：**\n- 日榜：`date.today() - timedelta(days=offset)`\n- 周榜：`date.today() - timedelta(weeks=offset)` 后的最近周一\n- 月榜：`date.today() - timedelta(days=30*offset)` 后的每月1日\n\n**更新规则（输出时告知用户）：**\n- 日榜：每日 **19:00** 更新\n- 周榜：每周一 **15:00** 更新\n- 月榜：每月 **1日 9:00** 更新\n#### ② 周期判断\n\n自动从用户文本中识别日/周/月（无明确则默认**日榜**）：\n- 含\"周\"/\"周榜\"→ `week`\n- 含\"月\"/\"月榜\"→ `month`\n- 其余默认 → `day`\n\n#### ③ 回溯范围校验\n\n| 榜单类型 | 最大回溯 | 超范围处理 |\n|---------|---------|-----------|\n| 日榜 | 近7天 | 自动切换至最近可用日期 |\n| 周榜 | 近3周 | 自动切换至最近可用日期 |\n| 月榜 | 近3个月 | 自动切换至最近可用日期 |\n\n**超出范围时**：-若用户查询当日及未来日期的榜单，在榜单说明输出中增加：「非常抱歉🙏，我们最新的是昨日/上周/上月的数据，将为您提供最接近您需求的昨日/上周/上月热榜。」\n-若用户查询时间早于回溯日期，在榜单说明输出中增"},{"path":"README.md","content":"# 小红书热门账号推荐 / xiaohongshu-top-account\n\n---\n\n## 简介\n\n想看小红书哪些账号最火、涨粉最猛？直接说品类就能查日榜、周榜、月榜 TOP50，覆盖美妆、美食、旅行、母婴等 25 个赛道，排名数据每日更新，自动生成可视化报告。\n\n**核心价值**\n\n- **榜单全面不遗漏** — 日榜/周榜/月榜三大周期，综合全部或细分赛道，TOP50 账号一目了然。\n- **品类精准不跑偏** — 说\"美食\"自动匹配美味佳肴赛道，说\"健身\"锁定体育锻炼，模糊词也能识别。\n- **报告直观可导出** — 自动生成精美 HTML 报告，支持一键导出 PDF/高清图片，账号名可直接跳转主页。\n- **订阅推送不操心** — 设置每日/每周/每月定时推送，榜单数据自动送到你面前。\n\n**适用对象**\n\n- 📊 **品牌/MCN 运营** — 快速锁定各赛道头部达人，为投放和合作提供数据支撑。\n- 📝 **小红书博主** — 了解同赛道热门账号动态，找到对标和学习对象。\n- 🔍 **内容研究者** — 跨品类、跨周期对比账号表现，洞察平台流量趋势。\n\n---\n\n## 功能特性\n\n### 核心功能\n\n- **排名查询**：查日榜、周榜、月榜 TOP50，默认展示 TOP20，追问即可查看全部。\n- **品类筛选**：支持 25 个赛道精准查询（美妆、美食、旅行、母婴、健身等），说赛道名自动匹配。\n- **可视化报告**：每次查询自动生成 HTML 报告，账号名可点击跳转主页，支持导出 PDF。\n- **定时订阅**：设置推送周期（每日/每周/每月），榜单数据定时送到你面前。\n- **历史回溯**：日榜回溯近 7 天，周榜近 3 周，月榜近 3 个月。\n\n---\n\n## 密钥获取与安全说明\n\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`) 提供。\n- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\n\n---\n\n## 使用指南\n\n直接用自然语言描述需求，无需记忆命令。\n\n### 常用说法速查\n\n| 意图 | 示例话术 | 效果 |\n|------|----------|------|\n| 查综合日榜 | \"小红书最新日榜\" | 返回全品类昨日 TOP20 账号排名 |\n| 查品类周榜 | \"美食周榜\" | 返回美味佳肴赛道上周 TOP20 |\n| 查月榜 | \"美妆月榜\" | 返回化妆美容赛道上月 TOP20 |\n| 查看全部 | \"看全部50条\" | 展开完整 TOP50 榜单并交付报告 |\n| 下载报告 | \"下载报告\" | 生成并交付 HTML 可视化报告文件 |\n| 订阅推送 | \"订阅每日榜单\" | 设置每日定时推送榜单数据 |\n\n### 输出示例\n\n查询后你会收到结构化的榜单表格，包含排名、账号名（可点击跳转主页）、综合评分、总粉丝数、新增笔记/粉丝/点赞/评论/收藏/分享等指标，并自动附带 HTML 报告文件。\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 示例问法 | 收益 |\n|------|------|----------|------|\n| 达人筛选 | 品牌/MCN | \"旅行赛道日榜，看看哪些账号最近涨粉猛\" | 快速锁定合作对象，数据说话 |\n| 竞品追踪 | 博主/运营 | \"订阅美妆赛道的每周排名\" | 定期收到同赛道头部账号动态 |\n| 趋势洞察 | 内容研究 | \"对比一下美食和健身赛道的月榜\" | 跨品类数据对比，发现流量趋势 |\n| 报告导出 | 数据分析 | \"查综合月榜，导出报告\" | 得到可分享的 HTML 报告文件 |\n\n---"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n \"slug\": \"xiaohongshu-rank-tracker\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1785217398511\n}"},{"path":"references/api_docs.md","content":"# 小红书榜单 API 接口文档\n\n## 接口基础信息\n\n| 字段 | 值 |\n|------|-----|\n| 接口地址 | `https://onetotenvip.com/story/xhsData/query` |\n| 请求方式 | POST |\n| Content-Type | `application/json` |\n| 认证方式 | 无（公开接口） |\n\n---\n\n## 请求参数（已校验）\n\n```json\n{\n \"dateType\": 1, // 榜单日期类型：1=日榜 2=周榜 3=月榜（必填）\n \"rankDate\": \"2026-04-28\", // 榜单日期 yyyy-MM-dd（必填）\n // 日榜：填当日日期，如 2026-04-28\n // 周榜：填该周**周一**日期，如 2026-04-20\n // 月榜：填该月第一天，如 2026-03-01\n \"type\": \"体育锻炼\", // 赛道分类，默认\"综合全部\"（必填）\n \"source\": \"小红书指数榜-ClawHub\" // 固定值（必填）\n}\n```\n\n> ⚠️ **重要**：`source` 必须为 `\"小红书指数榜\"`，使用其他值会导致接口返回空数据！\n> \n> ⚠️ 注意：`page`/`pageSize` 参数无效，接口每次固定返回 50 条数据。\n\n---\n\n## 响应结构（实际返回）\n\n```json\n{\n \"code\": 2000,\n \"data\": [\n {\n \"accountLink\": \"https://www.xiaohongshu.com/user/profile/...\",\n \"accountName\": \"恋与深空\",\n \"accountRanking\": 1,\n \"category\": \"数码科技\",\n \"fansCount\": \"254.06w\",\n \"fansGrowth\": \"6919\",\n \"likedGrowth\": \"24.64w\",\n \"commentsGrowth\": \"6.68w\",\n \"collectedGrowth\":\"2.53w\",\n \"sharedGrowth\": \"13.39w\",\n \"newNoteCount\": null,\n \"dataFetchTime\": \"2026-04-29 19:00:01\",\n \"rankDate\": \"2026-04-28\",\n \"rankPeriod\": \"日榜\"\n }\n ]\n}\n```\n\n> ⚠️ 注意：新接口**不返回** `comprehensiveScore`（综合评分）字段； \n> 互动数各字段均为**字符串格式**，如 `\"6.68w\"`、`\"1245\"`。\n\n---\n\n## 错误码\n\n| code | 含义 |\n|------|------|\n| 2000 | **成功**（注意：成功码是 2000 不是 0！） |\n| 其他 | 错误，data 为空数组 |\n\n---\n\n## 字段映射（fetch_rank.py normalized JSON）\n\n| 接口原始字段 | normalized 字段 | 含义 |\n|------------|----------------|------|\n| `accountRanking` | `rank` | 排名 |\n| `accountName` | `accountName` | 账号名 |\n| `category` | `category` | 赛道 |\n| `fansCount` | `followers` | 总粉丝数 |\n| `newNoteCount` | `newNoteCount` | 新增笔记数 |\n| `fansGrowth` | `newFans` | 新增粉丝 |\n| `likedGrowth` | `newLikes` | 新增点赞 |\n| `commentsGrowth` | `newComments` | 新增评论 |\n| `collectedGrowth` | `newCollects` | 新增收藏 |\n| `sharedGrowth` | `newShares` | 新增分享 |\n| `accountLink` | `profileUrl` | 主页链接 |\n\n---\n\n## 可用品类列表\n\n```\n综合全部\n出行代步 / 休闲爱好 / 影视娱乐 / 数码科技 / 医疗保健 / 综合杂项\n星座情感 / 时尚穿搭 / 婚庆婚礼 / 拍摄记录 / 学习教育 / 化妆美容\n居家装修 / 旅行度假 / 亲子育儿 / 个人护理 / 美味佳肴 / 职业发展\n宠物天地 / 潮流鞋包 / 日常生活 / 科学探索 / 新闻资讯 / 体育锻炼\n```\n\n**常用别名映射：**\n| 用户说 | 映射到 |\n|--------|--------|\n| 健身、运动、瑜伽 | 体育锻炼 |\n| 美妆、彩妆、护肤 | 化妆美容/个人护理 |\n| 美食、探店、烹饪 | 美味佳肴 |\n| 旅行、旅游 | 旅行度假 |\n| 母婴、育儿 | 亲子育儿 |\n| 穿搭、时尚 | 时尚穿搭 |\n\n---\n\n## 榜单更新规则\n\n| 榜单类型 | 更新时间 | 统计范围 | rankDate 填写规则 | 示例 |\n|---------|---------|---------|-----------------|------|\n| 日榜 | 每日 19:00 | 前一天 | 填当天日期 | \"2026-04-28\" |\n| 周榜 | 每周一 15:00 | 上周 | 填该周**周一**日期 | \"2026-04-20\" |\n| 月榜 | 每月1日 上午9:00 | 上月 | 填该月**1日** | \"2026-04-01\" |\n\n### 日期回退计算\n\n根据当前时间判断取第几期数据：\n\n| 榜单类型 | 当前时间 < 更新时间 | 当前时间 >= 更新时间 |\n|---------|-------------------|-------------------|\n| 日榜 (19:00更新) | offset=2 (前2天) | offset=1 (前1天) |\n| 周榜 (周一15:00更新) | offset=2 (前2周) | offset=1 (前1周) |\n| 月榜 (2号09:00更新) | offset=2 (前2月) | offset=1 (前1月) |\n\n> ⚠️ **月榜必须用每月1日**，实测用月末最后一天（如 \"2026-03-31\"）返回空数据！\n\n> ⚠️ **周榜用周一日期"},{"path":"references/score_rules.md","content":"# 小红书账号综合评分规则\n\n## 评分维度\n\n综合评分基于以下维度计算：\n\n| 维度 | 权重 | 计算方式 |\n|------|------|----------|\n| 总粉丝数 | 20% | ln(x+1)/ln(max+1) × 100 |\n| 新增粉丝 | 20% | ln(x+1)/ln(max+1) × 100 |\n| 新增点赞 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增收藏 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增分享 | 15% | ln(x+1)/ln(max+1) × 100 |\n| 新增评论 | 15% | ln(x+1)/ln(max+1) × 100 |\n\n## 计算公式\n\n对数归一化公式：\n```\nscore = ln(x + 1) / ln(max + 1) × 100\n```\n\n其中：\n- `x` 为该账号的当前指标值\n- `max` 为本次榜单中该指标的最大值\n\n## 示例\n\n假设某榜单数据如下：\n\n| 账号 | 新增点赞 | 得分计算 |\n|------|----------|----------|\n| A | 10万 | ln(100001)/ln(100001) × 100 = 100 |\n| B | 5万 | ln(50001)/ln(100001) × 100 ≈ 85 |\n| C | 1万 | ln(10001)/ln(100001) × 100 ≈ 67 |\n\n## 最终得分\n\n各维度加权求和后，保留整数作为综合评分。"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Skill: 小红书热门账号推荐 Owner: redfox-data Summary: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Tags: latest:1.0.2 Version history: v1.0.2 | 2026-07-28T05:43:18.511Z | user xiaohongshu-rank-tracker 1.0.2 更新日志 - 移除了 skill-card.md 说明文件，无其他功能或逻辑变更。 - 文档简化和部分描述调整，保持 Skill 主体功能不变。 v1.0.1 | 2026-06-02T09:52:06.655Z | user xiaohongshu-rank-tracker v1.0.1 - Renamed skill: now called \"xiaohongshu-top-account\" to better reflect the function","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":568,"uniquenessScore":66,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T07:25:59.093Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T07:25:59.093Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:51:27.750Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}