{"id":"5511f58c-b165-4177-88f5-6e692184fe57","entityType":"agent","slug":"clawhub-yuanyi-github-xiaohongshu-top-account","name":"小红书热门账号推荐","canonicalUrl":"https://www.xpersona.co/agent/clawhub-yuanyi-github-xiaohongshu-top-account","canonicalPath":"/agent/clawhub-yuanyi-github-xiaohongshu-top-account","generatedAt":"2026-10-11T08:42:24.400Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T06:05:09.016Z","emptyReason":null},"description":"小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Skill: 小红书热门账号推荐 Owner: yuanyi-github Summary: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-07-28T05:41:17.368Z | auto xiaohongshu-top-account 1.0.4 - 全面升级 SKILL.md，重点明确交互流程、输出模板及强制交付 HTML 报告要求，优化执行顺序与标准。 - 简化和精确了基础与高级用法说明，统一自然语言查询与参数调用入口。 - 明确API接口参数和赛道映射规则，强化日期/周期自动解析说明及数据回退处理机制。 - 更新订阅创建与流程细节，补充标准输出模板和 HTML 报告结构细节规范。 - 删除冗余 skill-card.md 文件。 - 优化参考文档说明与目录结构描述，使文档内容更清晰、易用。","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 s178m9shhypj2frsz7r1pz67kh84rb1r:xiaohongshu-top-account","sourceUrl":"https://clawhub.ai/yuanyi-github/xiaohongshu-top-account","homepage":"https://clawhub.ai/yuanyi-github/skills/xiaohongshu-top-account","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/yuanyi-github/xiaohongshu-top-account","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/yuanyi-github/skills/xiaohongshu-top-account","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Skill: 小红书热门账号推荐 Owner: yuanyi-github Summary: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Tags: latest:1.0.4 Version history: v1."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T06:05:09.016Z","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-11T06:05:09.016Z","emptyReason":null},"stars":null,"forks":null,"downloads":1138,"packageName":null,"latestVersion":"1.0.4","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T06:05:08.942Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T06:05:09.016Z","lastCrawledAt":"2026-10-11T06:05:08.942Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T06:05:08.942Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.4","createdAt":"2026-07-28T05:41:17.368Z","changelog":"xiaohongshu-top-account 1.0.4 - 全面升级 SKILL.md，重点明确交互流程、输出模板及强制交付 HTML 报告要求，优化执行顺序与标准。 - 简化和精确了基础与高级用法说明，统一自然语言查询与参数调用入口。 - 明确API接口参数和赛道映射规则，强化日期/周期自动解析说明及数据回退处理机制。 - 更新订阅创建与流程细节，补充标准输出模板和 HTML 报告结构细节规范。 - 删除冗余 skill-card.md 文件。 - 优化参考文档说明与目录结构描述，使文档内容更清晰、易用。","fileCount":9,"zipByteSize":34823},{"version":"1.0.3","createdAt":"2026-06-02T09:28:17.932Z","changelog":"**Summary:** Documentation clean-up and simplification, no logic/code changes. - Removed the redundant `skill-card.md` file for a cleaner directory. - Updated skill documentation for improved readability and conciseness. - Consolidated usage instructions, scenarios, and troubleshooting into clearer sections. - No runtime, feature, or output changes to the skill itself.","fileCount":9,"zipByteSize":35501},{"version":"1.0.2","createdAt":"2026-05-27T05:27:02.829Z","changelog":"xiaohongshu-top-account v1.0.2 - 新增英文及中文 README 文件，提供更完整的使用说明 - 优化了环境变量 REDFOX_API_KEY 的配置说明，新增 OpenClaw 配置示例 - 其他功能及接口、输出规范未改动","fileCount":9,"zipByteSize":38116},{"version":"1.0.1","createdAt":"2026-05-27T02:59:29.009Z","changelog":"xiaohongshu-top-account v1.0.1 changelog: - 更新 API Key 指引，获取方式改为直接前往红狐hub页面获取 - 精简和优化环境准备说明，使指引更加简洁明了 - 其他内容与交互流程未作修改，核心能力保持不变","fileCount":7,"zipByteSize":30914},{"version":"1.0.0","createdAt":"2026-05-26T12:18:44.027Z","changelog":"xiaohongshu-top-account 1.0.0 - 新增小红书全品类/分品类账号每日、每周、每月TOP50排行榜查询，支持美妆、美食、旅行、母婴、健身等领域筛选。 - 自动输出榜单数据（Markdown表格）并生成HTML报告，同时支持定时订阅推送服务。 - 环境准备与API Key配置流程详尽，支持平台差异自动设置。 - 智能解析用户自然语言，自动判断查询周期、类别及数据可用性，并实现多级数据回退机制。 - 标准化输出顺序，保障每次查询后附带订阅询问与HTML报告交付，提升交互体验。","fileCount":7,"zipByteSize":30969}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s178m9shhypj2frsz7r1pz67kh84rb1r:xiaohongshu-top-account","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-yuanyi-github-xiaohongshu-top-account/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yuanyi-github-xiaohongshu-top-account/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yuanyi-github-xiaohongshu-top-account/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yuanyi-github-xiaohongshu-top-account/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yuanyi-github-xiaohongshu-top-account/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yuanyi-github-xiaohongshu-top-account/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-11T08:42:24.399Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yuanyi-github-xiaohongshu-top-account/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yuanyi-github-xiaohongshu-top-account/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yuanyi-github-xiaohongshu-top-account/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yuanyi-github-xiaohongshu-top-account/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-11T06:05:09.016Z","emptyReason":null},"readme":"Skill: 小红书热门账号推荐\n\nOwner: yuanyi-github\n\nSummary: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号\n\nTags: latest:1.0.4\n\nVersion history:\n\nv1.0.4 | 2026-07-28T05:41:17.368Z | auto\n\nxiaohongshu-top-account 1.0.4\n\n- 全面升级 SKILL.md，重点明确交互流程、输出模板及强制交付 HTML 报告要求，优化执行顺序与标准。\n- 简化和精确了基础与高级用法说明，统一自然语言查询与参数调用入口。\n- 明确API接口参数和赛道映射规则，强化日期/周期自动解析说明及数据回退处理机制。\n- 更新订阅创建与流程细节，补充标准输出模板和 HTML 报告结构细节规范。\n- 删除冗余 skill-card.md 文件。\n- 优化参考文档说明与目录结构描述，使文档内容更清晰、易用。\n\nv1.0.3 | 2026-06-02T09:28:17.932Z | user\n\n**Summary:** Documentation clean-up and simplification, no logic/code changes.\n\n- Removed the redundant `skill-card.md` file for a cleaner directory.\n- Updated skill documentation for improved readability and conciseness.\n- Consolidated usage instructions, scenarios, and troubleshooting into clearer sections.\n- No runtime, feature, or output changes to the skill itself.\n\nv1.0.2 | 2026-05-27T05:27:02.829Z | user\n\nxiaohongshu-top-account v1.0.2\n\n- 新增英文及中文 README 文件，提供更完整的使用说明\n- 优化了环境变量 REDFOX_API_KEY 的配置说明，新增 OpenClaw 配置示例\n- 其他功能及接口、输出规范未改动\n\nv1.0.1 | 2026-05-27T02:59:29.009Z | user\n\nxiaohongshu-top-account v1.0.1 changelog:\n\n- 更新 API Key 指引，获取方式改为直接前往红狐hub页面获取\n- 精简和优化环境准备说明，使指引更加简洁明了\n- 其他内容与交互流程未作修改，核心能力保持不变\n\nv1.0.0 | 2026-05-26T12:18:44.027Z | user\n\nxiaohongshu-top-account 1.0.0\n\n- 新增小红书全品类/分品类账号每日、每周、每月TOP50排行榜查询，支持美妆、美食、旅行、母婴、健身等领域筛选。\n- 自动输出榜单数据（Markdown表格）并生成HTML报告，同时支持定时订阅推送服务。\n- 环境准备与API Key配置流程详尽，支持平台差异自动设置。\n- 智能解析用户自然语言，自动判断查询周期、类别及数据可用性，并实现多级数据回退机制。\n- 标准化输出顺序，保障每次查询后附带订阅询问与HTML报告交付，提升交互体验。\n\nArchive index:\n\nArchive v1.0.4: 9 files, 34823 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 (2378b), SKILL.md (14758b), _meta.json (142b)\n\nFile v1.0.4: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<div class=\"notice\">\n  <div style=\"margin-bottom: 8px;\">💡 <strong>榜单说明</strong>：{period_update_desc}更新，与实时数据存在差异。</div>\n  <div>📐 <strong>排名算法</strong>：排名根据达人在小红书的 <strong>总粉丝数</strong>、周期内的 <strong>粉丝增量</strong>、<strong>点赞增量</strong>、<strong>收藏增量</strong>、<strong>分享增量</strong> 以及 <strong>评论增量</strong> 加权计算所得。</div>\n</div>\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.4: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.4:_meta.json\n\n{\n  \"ownerId\": \"kn70p3je4506z0tw213zgq0r4584s0c6\",\n  \"slug\": \"xiaohongshu-top-account\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1785217277368\n}\n\nFile v1.0.4: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.4: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.4: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.4:skill-card.md\n\n## Description:\n\n小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[yuanyi-github](https://clawhub.ai/user/yuanyi-github)\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 account rankings by category, review top accounts, export HTML reports, and set scheduled 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 sends ranking requests to a third-party service.\n\nMitigation: Install only if you trust RedFox with the key, configure the key through environment variables, and confirm the key can be reset or revoked.\n\nRisk: Generated HTML reports may run active web content and contact a third-party CDN when opened.\n\nMitigation: Review generated reports before sharing or opening them in sensitive environments, and avoid using reports built from untrusted JSON or API data.\n\nRisk: Scheduled ranking pushes may create recurring local or platform notifications.\n\nMitigation: Confirm the requested cadence and category before enabling a subscription, and disable scheduled tasks that are no longer needed.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/yuanyi-github/skills/xiaohongshu-top-account)\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, shell commands, HTML files, configuration, guidance]\n\n**Output Format:** [Markdown ranking tables with optional generated HTML report files and setup commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires REDFOX_API_KEY; generated HTML reports may load third-party web resources when opened.]\n\n## Skill Version(s):\n\n1.0.4 (source: server 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.3: 9 files, 35501 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 (2754b), SKILL.md (10526b), _meta.json (142b)\n\nFile v1.0.3: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.3: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.3:_meta.json\n\n{\n  \"ownerId\": \"kn70p3je4506z0tw213zgq0r4584s0c6\",\n  \"slug\": \"xiaohongshu-top-account\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1780392497932\n}\n\nFile v1.0.3: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.3: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.3: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.3:skill-card.md\n\n## Description: <br>\n小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[yuanyi-github](https://clawhub.ai/user/yuanyi-github) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nContent creators, brands, MCN teams, and industry analysts use this skill to query Xiaohongshu daily, weekly, and monthly TOP 50 account rankings, filter by niche, generate visual HTML reports, and optionally subscribe to recurring ranking updates. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill requires REDFOX_API_KEY and sends authenticated outbound ranking API requests to redfox.hk. <br>\nMitigation: Install only if you trust RedFoxHub with the key, configure the key as an environment variable, and avoid exposing it in code, prompts, logs, or generated files. <br>\nRisk: Accepting a subscription prompt may create recurring automation that continues to call the service and send ranking updates. <br>\nMitigation: Review the subscription prompt, schedule, target niche, and delivery behavior before approving recurring updates. <br>\nRisk: Ranking outputs are based on periodic RedFox data and may differ from real-time Xiaohongshu platform state. <br>\nMitigation: Treat rankings as decision-support data and verify important creator, brand, or investment decisions against current source data. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/yuanyi-github/xiaohongshu-top-account) <br>\n- [Xiaohongshu ranking API documentation](artifact/references/api_docs.md) <br>\n- [Composite scoring rules](artifact/references/score_rules.md) <br>\n- [RedFoxHub API key settings](https://redfox.hk/settings/api-keys?source=clawhub) <br>\n- [RedFox Xiaohongshu ranking API endpoint](https://redfox.hk/story/api/xhsData/query) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, code, guidance] <br>\n**Output Format:** [Markdown ranking tables, HTML report files, subscription guidance, and shell/configuration snippets] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Default display is TOP 20; full TOP 50 can be requested with an HTML report. Outputs depend on RedFox API availability and REDFOX_API_KEY access.] <br>\n\n## Skill Version(s): <br>\n1.0.3 (source: evidence.release.version) <br>\n\n## Ethical Considerations: <br>\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. <br>\n\nArchive v1.0.2: 9 files, 38116 bytes\n\nFiles: README.en.md (9146b), README.md (7738b), references/api_docs.md (8044b), references/score_rules.md (989b), scripts/fetch_rank.py (36104b), scripts/generate_report.py (20262b), skill-card.md (2618b), SKILL.md (16420b), _meta.json (142b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: xiaohongshu-top-account\ndescription: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号\n---\n\n# 小红书热门账号推荐\n\n## 概述\n\n提供小红书全品类/分品类账号每日/每周/每月的表现榜单查询。支持三大核心能力：\n\n1. **排名查询** — 查日榜、周榜、月榜 TOP50\n2. **领域查询** — 按品类筛选（美妆、美食、旅行、母婴、健身/体育锻炼等）\n3. **报告下载** — 生成 HTML 可视化报告，支持导出 PDF/截图\n4. **定时订阅** — 设置自动化定时推送\n\n---\n\n## 环境准备\n\n无需安装第三方依赖，使用 Python 标准库 `urllib` 发送请求即可。\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| 用户意图 | 典型触发词                                                | 对应操作                      |\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<div class=\"notice\">\n  <div style=\"margin-bottom: 8px;\">\n    💡 <strong>榜单说明</strong>：{period_update_desc}更新，与实时数据存在差异。\n  </div>\n  <div>\n    📐 <strong>排名算法</strong>：排名根据达人在小红书的\n    <strong>总粉丝数</strong>、周期内的\n    <strong>粉丝增量</strong\n    >、<strong>点赞增量</strong>、<strong>收藏增量</strong>、<strong\n      >分享增量</strong\n    >\n    以及 <strong>评论增量</strong> 加权计算所得。\n  </div>\n</div>\n```\n\n---\n\n## API 参数说明\n\n### 接口信息\n\n- **URL**：`POST https://redfox.hk/story/api/xhsData/query`\n- **成功码**：`code: 2000`（非0！）\n- **认证方式**：`X-API-KEY` Header（从环境变量 `REDFOX_API_KEY` 获取）\n\n### 请求头\n\n| Header       | 值                 | 说明                                   |\n| ------------ | ------------------ | -------------------------------------- |\n| Content-Type | `application/json` | 必填                                   |\n| X-API-KEY    | `ak_xxxxxxxx`      | 从环境变量 `REDFOX_API_KEY` 获取，必填 |\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### 示例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.2:README.md\n\n# 小红书热门账号推荐 / xiaohongshu-top-account\r\n\r\n---\r\n\r\n## 简介\r\n\r\n帮你快速发现每日小红书平台最具影响力的账号，掌握赛道动态。\r\n\r\n**核心价值**\r\n基于每日小红书全赛道TOP50账号的涨粉、互动、增长趋势数据，帮你解决选题决策、对标账号、竞品监控、赛道选择四大核心问题。\r\n\r\n**适用对象**\r\n\r\n- 🎬 内容创作者 — 了解同赛道优秀账号表现，寻找对标和学习对象\r\n- 🏢 品牌方/商务投放 — 高效筛选优质达人，评估合作价值\r\n- 📦 MCN机构/内容团队 — 掌握竞品动态，制定运营策略\r\n- 📊 行业分析师 — 获取数据洞察，生成分析报告\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n\r\n- **排名查询**：查询小红书账号日榜、周榜、月榜 TOP 50 账号，默认展示 TOP 20\r\n- **赛道筛选**：支持小红书全站热门、或按 25 个赛道品类精准查询，支持模糊词匹配\r\n- **综合评分**：根据总粉丝数、新增粉丝、新增点赞/收藏/分享/评论加权计算，多维指标排名客观可信，满分 100 分\r\n- **HTML 报告生成**：生成带可视化布局的 HTML 文件，账号名可点击跳转小红书主页，支持导出图片或 PDF\r\n- **订阅推送**：支持设置日榜、周榜、月榜定时自动推送，也可按指定赛道订阅\r\n\r\n---\r\n\r\n## 密钥来源与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/dashboard/keys?souce=clawhub) (`https://redfox.hk`)签发，用于其接口鉴权。\r\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\r\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\r\n\r\n---\r\n\r\n## 前置条件\r\n\r\n### 注册红狐 hub 账号获取 REDFOX_API_KEY\r\n\r\n- 获取 REDFOX_API_KEY（前往 [红狐 hub](https://redfox.hk/dashboard/keys?souce=clawhub) 申请）\r\n\r\n### 环境变量配置\r\n\r\n| 变量名           | 必填 | 说明         |\r\n| ---------------- | ---- | ------------ |\r\n| `REDFOX_API_KEY` | 是   | API 访问密钥 |\r\n\r\n**macOS（zsh）**\r\n\r\n在 `~/.zshrc` 末尾添加一行（将引号内换成你的密钥）：\r\n\r\n```bash\r\nexport REDFOX_API_KEY=\"your_api_key_here\"\r\n```\r\n\r\n保存后执行：\r\n\r\n```bash\r\nsource ~/.zshrc\r\n```\r\n\r\n**Windows（PowerShell）**\r\n\r\n- **仅本次终端有效**：执行后立刻生效，**无需再跑别的命令**；关掉窗口后失效。\r\n\r\n```powershell\r\n$env:REDFOX_API_KEY = \"your_api_key_here\"\r\n```\r\n\r\n- **写入用户环境变量（持久）**：执行 `setx` 后，**当前这个 PowerShell 窗口里仍然没有该变量**，需要 **关闭并重新打开** 终端（或重启 Cursor / VS Code 等），新开的窗口里才会读到 `REDFOX_API_KEY`。\r\n\r\n```powershell\r\nsetx REDFOX_API_KEY \"your_api_key_here\"\r\n```\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n直接用自然语言描述你的需求，无需记忆任何命令格式。\r\n\r\n### 常用说法速查\r\n\r\n| 意图       | 示例话术                               | 效果                            |\r\n| ---------- | -------------------------------------- | ------------------------------- |\r\n| 查日榜     | \"最新小红书账号日榜排名？\"             | 返回全品类最新日榜 TOP 20       |\r\n| 查赛道周榜 | \"上周小红书美食类账号排行怎么样？\"     | 返回美味佳肴赛道最新周榜 TOP 20 |\r\n| 查月榜     | \"帮我看看上个月美妆类小红书账号的榜单\" | 返回化妆美容赛道最新月榜 TOP 20 |\r\n| 查完整榜单 | \"我想看完整的50条\"                     | 展示完整 TOP 50 并生成报告      |\r\n| 下载报告   | \"帮我生成这次榜单的 HTML 报告\"         | 生成可视化 HTML 文件并交付      |\r\n| 订阅推送   | \"我想每天收到美食类小红书日榜更新\"     | 创建定时自动推送任务            |\r\n\r\n### 输出示例\r\n\r\n📊 小红书日榜 · 全品类\r\n\r\n数据日期：2026-04-28\r\n共 50 个账号上榜（展示 TOP 20 条）\r\n\r\n💡 榜单说明：数据于每日19:00更新昨日数据，与实时数据存在差异\r\n\r\n📐 排名算法：根据达人在小红书的总粉丝数、周期内粉丝增量、点赞增量、收藏增量、分享增量以及评论增量加权计算，满分100\r\n\r\n| 排名 | 账号名           | 综合评分 | 总粉丝数 | 新增笔记 | 新增粉丝 | 新增点赞 | 新增评论 | 新增收藏 | 新增分享 |\r\n| :--: | ---------------- | :------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: |\r\n| 🥇 1 | 账号名（可点击） |    96    |   254w   |    7     |   6919   |  24.6w   |   6.7w   |   2.5w   |  13.4w   |\r\n| 🥈 2 | 账号名（可点击） |    89    |   113w   |    1     |   1.9w   |   7.9w   |   4787   |   2.2w   |   3.1w   |\r\n|  …   | …                |    …     |    …     |    …     |    …     |    …     |    …     |    …     |    …     |\r\n\r\n⚡ 更多操作\r\n⏺️ 本次榜单完整共 50 条数据，是否需要查看剩余 30 条？\r\n\r\n📬 订阅服务\r\n1️⃣ 是否需要订阅每日/周/月的小红书账号最新排名？\r\n2️⃣ 是否需要订阅具体赛道的账号表现？\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景                 | 角色                  | 示例问法                                    | 收益                               |\r\n| -------------------- | --------------------- | ------------------------------------------- | ---------------------------------- |\r\n| 寻找赛道标杆账号     | 内容创作者 / 个体运营 | \"美妆类账号哪些做得好？帮我看看最新日榜\"    | 快速找到行业头部，明确内容方向     |\r\n| 评估达人合作候选人   | 品牌方 / 商务投放     | \"上周小红书穿搭类TOP50有哪些账号表现亮眼？\" | 批量筛选，提升投放决策效率         |\r\n| 监控竞品赛道动态     | MCN 机构 / 内容团队   | \"最近一周美食账号有哪些涨粉最快？\"          | 实时掌握竞争格局，快速响应市场变化 |\r\n| 生成行业分析报告     | 行业分析师 / 咨询顾问 | \"帮我生成3月份小红书科技类榜单分析报告\"     | 一键生成可视化 HTML，方便汇报分享  |\r\n| 定期追踪账号排名变化 | 运营团队              | \"我想每周一收到旅行赛道的最新周榜\"          | 订阅推送，自动化榜单情报获取       |\r\n\r\n---\r\n\r\n## 重要数据说明\r\n\r\n### 榜单更新时间与数据回溯\r\n\r\n| 榜单类型 | 更新时间                    | 可回溯范围  |\r\n| -------- | --------------------------- | ----------- |\r\n| 日榜     | 每日 19:00 更新昨日数据     | 过去 7 天   |\r\n| 周榜     | 每周一 15:00 更新上周数据   | 过去 3 周   |\r\n| 月榜     | 每月 2 号 9:00 更新上月数据 | 过去 3 个月 |\r\n\r\n### 支持赛道（25 个）\r\n\r\n综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\r\n\r\n### 综合评分说明\r\n\r\n评分根据总粉丝数（20%）、新增粉丝（20%）、新增点赞（15%）、新增收藏（15%）、新增分享（15%）、新增评论（15%）加权计算，满分 100 分。采用对数归一化公式，避免头部账号过度拉分，使中腰部账号排名更具参考性。\r\n\r\n### 数据时效\r\n\r\n数据非实时更新，账号互动数据为采集时刻的真实数据，与实时数据存在差异。\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn70p3je4506z0tw213zgq0r4584s0c6\",\n  \"slug\": \"xiaohongshu-top-account\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1779859622829\n}\n\nFile v1.0.2: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\": \"小红书指数榜\" // 固定值（必填）\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\": \"小红书指数榜\"\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\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.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\r\n\r\n---\r\n\r\n## Overview\r\n\r\nQuickly discover the most influential accounts on Xiaohongshu and stay on top of niche trends.\r\n\r\n**Core Value**\r\n\r\nBased on daily TOP 50 account data across all Xiaohongshu niches — covering follower growth, engagement, and growth trends — this tool helps you tackle four key challenges: content topic decisions, benchmark account discovery, competitor monitoring, and niche selection.\r\n\r\n**Intended Users**\r\n\r\n- 🎬 Content creators — understand top account performance in your niche, find benchmarks to learn from\r\n- 🏢 Brand owners / ad placement teams — efficiently shortlist quality influencers and evaluate partnership value\r\n- 📦 MCN agencies / content teams — track competitor dynamics and develop operational strategies\r\n- 📊 Industry analysts — obtain data insights and generate analysis reports\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Ranking queries**: query daily, weekly, and monthly TOP 50 Xiaohongshu accounts; default display is TOP 20\r\n- **Niche filtering**: supports all-category trending or precise queries across 25 content niches, with fuzzy keyword matching\r\n- **Composite scoring**: weighted calculation based on total followers, new follower growth, and new likes/collects/shares/comments; multi-dimensional, objective ranking out of 100\r\n- **HTML report generation**: generates a visually styled HTML file with clickable account names linking to Xiaohongshu profiles; supports export as image or PDF\r\n- **Subscription push**: set up scheduled auto-delivery for daily, weekly, or monthly rankings; supports niche-specific subscriptions\r\n\r\n---\r\n\r\n## API key source and security\r\n\r\n- This skill requires the environment variable: `REDFOX_API_KEY`.\r\n- `REDFOX_API_KEY` is issued by [Redfox Hub](https://redfox.hk/dashboard/keys?souce=clawhub) (`https://redfox.hk`) for API authentication.\r\n- Before providing the key, confirm its source, available scope, validity period, and whether reset/revocation is supported.\r\n- Do not hard-code or expose the key in plaintext within code, prompts, logs, or output files.\r\n\r\n---\r\n\r\n## Prerequisites\r\n\r\n### Register a Redfox Hub account to obtain REDFOX_API_KEY\r\n\r\n- Get REDFOX_API_KEY (apply at [Redfox Hub](https://redfox.hk/dashboard/keys?souce=clawhub))\r\n\r\n### Environment variables\r\n\r\n| Variable         | Required | Notes          |\r\n| ---------------- | -------- | -------------- |\r\n| `REDFOX_API_KEY` | Yes      | API access key |\r\n\r\n**macOS (zsh)**\r\n\r\nAppend one line to the end of `~/.zshrc` (replace the value in quotes with your key):\r\n\r\n```bash\r\nexport REDFOX_API_KEY=\"your_api_key_here\"\r\n```\r\n\r\nThen run:\r\n\r\n```bash\r\nsource ~/.zshrc\r\n```\r\n\r\n**Windows (PowerShell)**\r\n\r\n- **Current terminal only**: Takes effect immediately after run, **no other commands needed**; lost when the window is closed.\r\n\r\n```powershell\r\n$env:REDFOX_API_KEY = \"your_api_key_here\"\r\n```\r\n\r\n- **Persist to user environment**: After running `setx`, the **current PowerShell window still won't have the variable**; you need to **close and reopen** the terminal (or restart Cursor / VS Code, etc.) for the new window to read `REDFOX_API_KEY`.\r\n\r\n```powershell\r\nsetx REDFOX_API_KEY \"your_api_key_here\"\r\n```\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\nSimply describe your needs in natural language — no commands to memorize.\r\n\r\n### Quick Reference\r\n\r\n| Intent               | Example phrase                                         | Result                             |\r\n| -------------------- | ------------------------------------------------------ | ---------------------------------- |\r\n| Daily ranking        | \"What's the latest Xiaohongshu daily ranking?\"         | Latest all-category daily TOP 20   |\r\n| Niche weekly ranking | \"How did food accounts rank on Xiaohongshu last week?\" | Latest food niche weekly TOP 20    |\r\n| Monthly ranking      | \"Show me last month's beauty Xiaohongshu rankings\"     | Latest beauty monthly TOP 20       |\r\n| Full ranking list    | \"I want to see all 50\"                                 | Full TOP 50 with generated report  |\r\n| Download report      | \"Generate an HTML report for this ranking\"             | Visual HTML file delivered         |\r\n| Subscribe push       | \"I want daily updates on the Xiaohongshu food ranking\" | Creates a scheduled auto-push task |\r\n\r\n### Output Example\r\n\r\n📊 Xiaohongshu Daily Ranking · All Categories\r\n\r\nData date: 2026-04-28\r\n50 accounts on the list (showing TOP 20)\r\n\r\n💡 Note: Data is updated daily at 19:00 with the previous day's figures; a time lag from live data exists.\r\n\r\n📐 Ranking algorithm: Weighted by total followers, follower growth, new likes/collects/shares/comments within the period; full score 100.\r\n\r\n| Rank | Account                  | Score | Total Followers | New Notes | New Followers | New Likes | New Comments | New Collects | New Shares |\r\n| :--: | ------------------------ | :---: | :-------------: | :-------: | :-----------: | :-------: | :----------: | :----------: | :--------: |\r\n| 🥇 1 | Account Name (clickable) |  96   |      2.54M      |     7     |     6,919     |   246K    |     67K      |     25K      |    134K    |\r\n| 🥈 2 | Account Name (clickable) |  89   |      1.13M      |     1     |      19K      |    79K    |    4,787     |     22K      |    31K     |\r\n|  …   | …                        |   …   |        …        |     …     |       …       |     …     |      …       |      …       |     …      |\r\n\r\n⚡ More Options\r\n⏺️ This ranking has 50 entries in total. Would you like to see the remaining 30?\r\n\r\n📬 Subscription\r\n1️⃣ Would you like to subscribe to the latest daily/weekly/monthly Xiaohongshu account rankings?\r\n2️⃣ Would you like to subscribe to account performance for a specific niche?\r\n\r\n---\r\n\r\n## Use Cases\r\n\r\n| Scenario                                   | Role                                  | Example Question                                                              | Benefit                                                                             |\r\n| ------------------------------------------ | ------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |\r\n| Find benchmark accounts in a niche         | Content creator / individual operator | \"Which beauty accounts are performing well? Show me the latest daily ranking\" | Quickly identify industry leaders and clarify content direction                     |\r\n| Evaluate influencer partnership candidates | Brand / ad placement team             | \"Which fashion accounts stood out in last week's Xiaohongshu TOP 50?\"         | Batch screening for more efficient campaign decisions                               |\r\n| Monitor competitor niche dynamics          | MCN agency / content team             | \"Which food accounts grew the fastest this week?\"                             | Stay on top of the competitive landscape and respond to market changes in real time |\r\n| Generate industry analysis reports         | Industry analyst / consultant         | \"Generate a March Xiaohongshu tech category ranking report for me\"            | One-click visual HTML, easy to share in presentations                               |\r\n| Track account ranking changes over time    | Operations team                       | \"I want the latest travel niche weekly ranking every Monday\"                  | Automated ranking intelligence via subscription push                                |\r\n\r\n---\r\n\r\n## Important Data Notes\r\n\r\n### Update Schedule and Data Lookback\r\n\r\n| Ranking Type | Update Time                                                     | Lookback Range |\r\n| ------------ | --------------------------------------------------------------- | -------------- |\r\n| Daily        | Updated at 19:00 every day with previous day's data             | Past 7 days    |\r\n| Weekly       | Updated every Monday at 15:00 with last week's data             | Past 3 weeks   |\r\n| Monthly      | Updated on the 2nd of each month at 9:00 with last month's data | Past 3 months  |\r\n\r\n### Supported Niches (25)\r\n\r\nAll Categories, Commuting, Leisure & Hobbies, Film & Entertainment, Consumer Tech, Health & Medical, General Misc, Astrology & Relationships, Fashion & Outfits, Wedding, Photography & Vlog, Education, Beauty & Makeup, Home Decor, Travel, Parenting, Personal Care, Food & Dining, Career Development, Pets, Trendy Shoes & Bags, Daily Life, Science & Discovery, News & Current Affairs, Fitness & Sports\r\n\r\n### Composite Score Explanation\r\n\r\nThe score is calculated by weighting total followers (20%), new follower growth (20%), new likes (15%), new collects (15%), new shares (15%), and new comments (15%), on a scale of 0–100. A logarithmic normalization formula is used to prevent top accounts from skewing the distribution, making mid-tier rankings more meaningful.\r\n\r\n### Data Freshness\r\n\r\nData is not updated in real time. Account engagement figures reflect the values captured at collection time and may differ from live platform data.\n\nFile v1.0.2:skill-card.md\n\n## Description: <br>\n小红书账号榜单追踪分析工具，支持查询日榜、周榜、月榜 TOP50 排名和热门账号。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[yuanyi-github](https://clawhub.ai/user/yuanyi-github) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nContent creators, brand teams, MCN operators, and analysts use this skill to discover influential Xiaohongshu accounts, compare niche rankings, monitor competitor movement, and generate shareable ranking reports. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill requires a Redfox API key and sends Xiaohongshu ranking queries to redfox.hk. <br>\nMitigation: Store REDFOX_API_KEY only in the agent environment or approved configuration, confirm the key scope and revocation process, and avoid exposing it in prompts, logs, or generated reports. <br>\nRisk: The skill can guide users toward recurring ranking subscriptions or calendar automation. <br>\nMitigation: Confirm the ranking category, cadence, delivery destination, and cancellation or review process before enabling any recurring task. <br>\nRisk: Ranking data is not real time and may differ from live Xiaohongshu account metrics. <br>\nMitigation: Present the data date and update schedule with ranking results, and treat reports as decision support rather than live platform truth. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/yuanyi-github/xiaohongshu-top-account) <br>\n- [API documentation](references/api_docs.md) <br>\n- [Score rules](references/score_rules.md) <br>\n- [Redfox API key settings](https://redfox.hk/settings/api-keys?source=clawhub) <br>\n- [Redfox Xiaohongshu ranking API](https://redfox.hk/story/api/xhsData/query) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, HTML files, guidance] <br>\n**Output Format:** [Markdown ranking summaries with tables, local HTML report files, and setup or subscription guidance.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires REDFOX_API_KEY for Redfox API access; generated HTML reports may include links to Xiaohongshu account profiles.] <br>\n\n## Skill Version(s): <br>\n1.0.2 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\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. <br>\n\nArchive v1.0.1: 7 files, 30914 bytes\n\nFiles: references/api_docs.md (8481b), references/score_rules.md (989b), scripts/fetch_rank.py (36104b), scripts/generate_report.py (20262b), skill-card.md (2098b), SKILL.md (16858b), _meta.json (142b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: xiaohongshu-top-account\ndescription: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号\n---\n\n# 小红书热门账号推荐\n\n## 概述\n\n提供小红书全品类/分品类账号每日/每周/每月的表现榜单查询。支持三大核心能力：\n\n1. **排名查询** — 查日榜、周榜、月榜 TOP50\n2. **领域查询** — 按品类筛选（美妆、美食、旅行、母婴、健身/体育锻炼等）\n3. **报告下载** — 生成 HTML 可视化报告，支持导出 PDF/截图\n4. **定时订阅** — 设置自动化定时推送\n\n---\n\n## 环境准备\n\n无需安装第三方依赖，使用 Python 标准库 `urllib` 发送请求即可。\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- `REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`\n- 若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若用户不会配置，Agent应主动帮用户设置：\n  - **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效\n  - **Windows**：使用 `[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<值>\", \"User\")` 设置用户级永久环境变量（需重启终端生效）\n  - 配置完成后应验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确保换一个skill也能读取到\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<div class=\"notice\">\n  <div style=\"margin-bottom: 8px;\">\n    💡 <strong>榜单说明</strong>：{period_update_desc}更新，与实时数据存在差异。\n  </div>\n  <div>\n    📐 <strong>排名算法</strong>：排名根据达人在小红书的\n    <strong>总粉丝数</strong>、周期内的\n    <strong>粉丝增量</strong\n    >、<strong>点赞增量</strong>、<strong>收藏增量</strong>、<strong\n      >分享增量</strong\n    >\n    以及 <strong>评论增量</strong> 加权计算所得。\n  </div>\n</div>\n```\n\n---\n\n## API 参数说明\n\n### 接口信息\n\n- **URL**：`POST https://redfox.hk/story/api/xhsData/query`\n- **成功码**：`code: 2000`（非0！）\n- **认证方式**：`X-API-KEY` Header（从环境变量 `REDFOX_API_KEY` 获取）\n\n### 请求头\n\n| Header       | 值                 | 说明                                   |\n| ------------ | ------------------ | -------------------------------------- |\n| Content-Type | `application/json` | 必填                                   |\n| X-API-KEY    | `ak_xxxxxxxx`      | 从环境变量 `REDFOX_API_KEY` 获取，必填 |\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### 示例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.1:_meta.json\n\n{\n  \"ownerId\": \"kn70p3je4506z0tw213zgq0r4584s0c6\",\n  \"slug\": \"xiaohongshu-top-account\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1779850769009\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=github) 获取API KEY\n\n#### 配置 API Key\n\n- `REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`\n- 若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若用户不会配置，Agent应主动帮用户设置：\n  - **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效\n  - **Windows**：使用 `[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<值>\", \"User\")` 设置用户级永久环境变量（需重启终端生效）\n  - 配置完成后应验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确保换一个skill也能读取到\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### 请求头\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\": \"小红书指数榜\"\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\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:skill-card.md\n\n## Description: <br>\nQueries Xiaohongshu account ranking lists by period and category, then formats ranked results and downloadable HTML reports. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[yuanyi-github](https://clawhub.ai/user/yuanyi-github) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and analysts use this skill to retrieve Xiaohongshu top-account rankings, filter by category, generate Markdown summaries, and create HTML reports for review or sharing. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill asks agents to persist API credentials in shell profiles or user-level environment settings. <br>\nMitigation: Prefer session-only credentials or a dedicated secret manager, and avoid writing API keys to global profile files unless the user explicitly approves. <br>\nRisk: The skill may trigger broadly for Xiaohongshu ranking-related requests and make external Redfox API queries. <br>\nMitigation: Confirm the user's intended query, category, subscription setup, and file generation before running external requests or creating recurring tasks. <br>\n\n\n## Reference(s): <br>\n- [小红书榜单 API 接口文档](references/api_docs.md) <br>\n- [小红书账号综合评分规则](references/score_rules.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown responses with tables plus optional generated HTML report files] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Uses REDFOX_API_KEY for authenticated Redfox API queries and may generate local HTML report artifacts.] <br>\n\n## Skill Version(s): <br>\n1.0.1 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\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. <br>\n\nArchive v1.0.0: 7 files, 30969 bytes\n\nFiles: references/api_docs.md (8063b), references/score_rules.md (989b), scripts/fetch_rank.py (36336b), scripts/generate_report.py (20262b), skill-card.md (2170b), SKILL.md (15673b), _meta.json (142b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: xiaohongshu-top-account\ndescription: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号\n---\n\n# 小红书热门账号推荐\n\n## 概述\n\n提供小红书全品类/分品类账号每日/每周/每月的表现榜单查询。支持三大核心能力：\n1. **排名查询** — 查日榜、周榜、月榜 TOP50\n2. **领域查询** — 按品类筛选（美妆、美食、旅行、母婴、健身/体育锻炼等）\n3. **报告下载** — 生成 HTML 可视化报告，支持导出 PDF/截图\n4. **定时订阅** — 设置自动化定时推送\n\n---\n\n## 环境准备\n\n无需安装第三方依赖，使用 Python 标准库 `urllib` 发送请求即可。\n\n### 鉴权\n\n#### 获取 API Key\n1. 访问 [RedFox 官网](https://redfox.hk/) 了解服务详情\n2. 前往 [注册页面](https://redfox.hk/login) 注册账号\n3. **新注册用户将获赠免费积分**，可立即开始使用 API 服务\n4. 注册登录后，在个人中心获取 API Key，格式为 `ak_xxxxxxxx`\n\n#### 配置 API Key\n- `REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`\n- 若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若用户不会配置，Agent应主动帮用户设置：\n  - **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效\n  - **Windows**：使用 `[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<值>\", \"User\")` 设置用户级永久环境变量（需重启终端生效）\n  - 配置完成后应验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确保换一个skill也能读取到\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| 月榜 | 每月2号 上午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)` 后的每月2号\n\n**更新规则（输出时告知用户）：**\n- 日榜：每日 **19:00** 更新\n- 周榜：每周一 **15:00** 更新\n- 月榜：每月 **2号 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/每月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• 点击下方下载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<div class=\"notice\">\n  <div style=\"margin-bottom: 8px;\">💡 <strong>榜单说明</strong>：{period_update_desc}更新，与实时数据存在差异。</div>\n  <div>📐 <strong>排名算法</strong>：排名根据达人在小红书的 <strong>总粉丝数</strong>、周期内的 <strong>粉丝增量</strong>、<strong>点赞增量</strong>、<strong>收藏增量</strong>、<strong>分享增量</strong> 以及 <strong>评论增量</strong> 加权计算所得。</div>\n</div>\n```\n\n---\n\n## API 参数说明\n\n### 接口信息\n- **URL**：`POST https://redfox.hk/story/api/xhsData/query`\n- **成功码**：`code: 2000`（非0！）\n- **认证方式**：`X-API-KEY` Header（从环境变量 `REDFOX_API_KEY` 获取）\n\n### 请求头\n\n| Header | 值 | 说明 |\n|--------|-----|------|\n| Content-Type | `application/json` | 必填 |\n| X-API-KEY | `ak_xxxxxxxx` | 从环境变量 `REDFOX_API_KEY` 获取，必填 |\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### 示例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- **月榜日期参数必须使用每月2号**，如查询上月榜单用 \"2026-04-02\"。\n- **体育锻炼分类**：部分日期可能返回空数据，需要自动回退日期。\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn70p3je4506z0tw213zgq0r4584s0c6\",\n  \"slug\": \"xiaohongshu-top-account\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1779797924027\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| 认证方式 | `X-API-KEY` Header（从环境变量 `REDFOX_API_KEY` 获取） |\n\n### 鉴权\n\n#### 获取 API Key\n1. 访问 [RedFox 官网](https://redfox.hk/) 了解服务详情\n2. 前往 [注册页面](https://redfox.hk/login) 注册账号\n3. **新注册用户将获赠免费积分**，可立即开始使用 API 服务\n4. 注册登录后，在个人中心获取 API Key，格式为 `ak_xxxxxxxx`\n\n#### 配置 API Key\n- `REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`\n- 若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若用户不会配置，Agent应主动帮用户设置：\n  - **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效\n  - **Windows**：使用 `[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<值>\", \"User\")` 设置用户级永久环境变量（需重启终端生效）\n  - 配置完成后应验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确保换一个skill也能读取到\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### 请求头\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```\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 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\": \"小红书指数榜\"\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\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.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: <br>\n小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[yuanyi-github](https://clawhub.ai/user/yuanyi-github) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and analysts use this skill to query Xiaohongshu daily, weekly, and monthly account rankings by category, receive Markdown leaderboard summaries, and generate HTML reports for review. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The security evidence reports suspicious credential handling because the skill's setup guidance can encourage permanent, cross-skill exposure of the RedFox API key. <br>\nMitigation: Use a per-session environment variable or a platform secret manager, avoid storing the key permanently in shell profiles or user-level environment variables, and do not echo the key in terminal output. <br>\n\n\n## Reference(s): <br>\n- [API documentation](references/api_docs.md) <br>\n- [Scoring rules](references/score_rules.md) <br>\n- [RedFox service](https://redfox.hk/) <br>\n- [RedFox Xiaohongshu ranking API endpoint](https://redfox.hk/story/api/xhsData/query) <br>\n- [ClawHub skill page](https://clawhub.ai/yuanyi-github/xiaohongshu-top-account) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Files, Guidance] <br>\n**Output Format:** [Markdown leaderboard summaries, shell command snippets, configuration guidance, and generated HTML report files] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires a REDFOX_API_KEY credential and network access to the RedFox API; reports may include Xiaohongshu profile links.] <br>\n\n## Skill Version(s): <br>\n1.0.0 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\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. <br>","readmeExcerpt":"Skill: 小红书热门账号推荐 Owner: yuanyi-github Summary: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-07-28T05:41:17.368Z | auto xiaohongshu-top-account 1.0.4 - 全面升级 SKILL.md，重点明确交互流程、输出模板及强制交付 HTML 报告要求，优化执行顺序与标准。 - 简化和精确了基础与高级用法说明，统一自然语言查询与参数调用入口。 - 明确API接口参数和赛道映射规则，强化日期/周期自动解析说明及数据回退处理机制。 - 更新订阅创建与流程细节，补充标准输出模板和 HTML 报告结构细节规范。 - 删除冗余 skill-card.md 文件。 - 优化参考文档说明与目录结构描述，使文档内容更清晰、易用。 ","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\": \"kn70p3je4506z0tw213zgq0r4584s0c6\",\n  \"slug\": \"xiaohongshu-top-account\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1785217277368\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: yuanyi-github Summary: 小红书账号榜单追踪分析工具，支持查询日榜周榜月榜TOP50排名和热门账号 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-07-28T05:41:17.368Z | auto xiaohongshu-top-account 1.0.4 - 全面升级 SKILL.md，重点明确交互流程、输出模板及强制交付 HTML 报告要求，优化执行顺序与标准。 - 简化和精确了基础与高级用法说明，统一自然语言查询与参数调用入口。 - 明确API接口参数和赛道映射规则，强化日期/周期自动解析说明及数据回退处理机制。 - 更新订阅创建与流程细节，补充标准输出模板和 HTML 报告结构细节规范。 - 删除冗余 skill-card.md 文件。 - 优化参考文档说明与目录结构描述，使文档内容更清晰、易用。","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":556,"uniquenessScore":65,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T06:05:09.016Z","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-11T06:05:09.016Z","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-11T08:42:24.400Z","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"}]}}}