{"id":"66e5ca8c-9ce5-41d2-86d7-cb507e0d67d1","entityType":"agent","slug":"clawhub-if530770-xhs-daily-ranking","name":"小红书每日爆款笔记","canonicalUrl":"https://www.xpersona.co/agent/clawhub-if530770-xhs-daily-ranking","canonicalPath":"/agent/clawhub-if530770-xhs-daily-ranking","generatedAt":"2026-10-11T03:56:43.225Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T01:33:20.838Z","emptyReason":null},"description":"小红书每日爆款笔记是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。 Skill: 小红书每日爆款笔记 Owner: if530770 Summary: 小红书每日爆款笔记是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-06-05T03:33:07.637Z | user **v1.0.5 Changelog:** - Added English and Chinese README files for better documentation (README.en.md, README.md). - Removed outdated documentation file (","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17dj64hf08x3mak1j99vesphd84gs9c:xhs-daily-ranking","sourceUrl":"https://clawhub.ai/if530770/xhs-daily-ranking","homepage":"https://clawhub.ai/if530770/skills/xhs-daily-ranking","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/if530770/xhs-daily-ranking","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/if530770/skills/xhs-daily-ranking","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":62,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"小红书每日爆款笔记是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。 Skill: 小红书每日爆"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T01:33:20.838Z","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-11T01:33:20.838Z","emptyReason":null},"stars":null,"forks":null,"downloads":1204,"packageName":null,"latestVersion":"1.0.5","tractionLabel":"1.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T01:33:20.774Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T01:33:20.838Z","lastCrawledAt":"2026-10-11T01:33:20.774Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T01:33:20.774Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.5","createdAt":"2026-06-05T03:33:07.637Z","changelog":"**v1.0.5 Changelog:** - Added English and Chinese README files for better documentation (README.en.md, README.md). - Removed outdated documentation file (skill-card.md). - Updated and expanded SKILL.md: - Improved feature and usage instructions with detailed scenarios and step-by-step guides. - Clarified environment variable/API key setup and installation for different platforms. - Enhanced FAQ, output specification, and workflow guidance. - Provided clearer module structure overview and execution constraints.","fileCount":9,"zipByteSize":52155},{"version":"1.0.4","createdAt":"2026-05-15T03:51:02.806Z","changelog":"- Removed file: _skillhub_meta.json - No user-facing features or workflow changed. - Minor cleanup to project files.","fileCount":7,"zipByteSize":42241},{"version":"1.0.3","createdAt":"2026-05-08T11:25:08.660Z","changelog":"xhs-daily-ranking 1.0.3 - 更新了技能描述，突出支持多分类查询、单日爆款笔记分析、趋势追踪与创作灵感提炼。 - 其余功能、输出规范与用法保持一致。","fileCount":7,"zipByteSize":41135},{"version":"1.0.2","createdAt":"2026-04-29T12:28:35.655Z","changelog":"xhs-daily-ranking 1.0.2 - 简化/收敛高级用法描述，分类匹配规则仅在内部执行，不再直接向用户展示映射细节。 - 删除/精简部分场景、收益等表述，调整表格内容结构。 - 保持所有功能点、输出规范和命令一致，无功能变更。 - 其他文档细节优化，提升可读性和简洁性。","fileCount":7,"zipByteSize":40928},{"version":"1.0.1","createdAt":"2026-04-29T11:39:26.390Z","changelog":"- 更新了完整功能流程参考文档路径，从 assets/core_workflow.md 移动到 references/core_workflow.md - 对相关文档链接和资源索引进行了相应调整 - 移除了无效的 assets/core_workflow.md 引用 - 其余功能与使用方式不变","fileCount":7,"zipByteSize":42582},{"version":"1.0.0","createdAt":"2026-04-29T09:25:00.817Z","changelog":"xhs-daily-ranking 1.0.0 — 首发版本，提供小红书单日爆发榜查询与数据分析能力。 - 支持查询小红书平台当日TOP50爆款笔记，按25大分类快速检索 - 自动生成3项分析报告及可视化HTML页面，Markdown/HTML多格式输出 - 提供每日19:30榜单订阅推送，无需小红书账号或API密钥 - 可按关键词/分类/日期精准检索并导出爆文数据 - 内置命令、使用场景与完整输出规范，便于内容创作者与运营分析使用","fileCount":7,"zipByteSize":42443}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17dj64hf08x3mak1j99vesphd84gs9c:xhs-daily-ranking","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","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-if530770-xhs-daily-ranking/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-daily-ranking/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-daily-ranking/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-daily-ranking/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-daily-ranking/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-daily-ranking/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-11T03:56:43.222Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-daily-ranking/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-daily-ranking/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-daily-ranking/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-daily-ranking/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-11T01:33:20.838Z","emptyReason":null},"readme":"Skill: 小红书每日爆款笔记\n\nOwner: if530770\n\nSummary: 小红书每日爆款笔记是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。\n\nTags: latest:1.0.5\n\nVersion history:\n\nv1.0.5 | 2026-06-05T03:33:07.637Z | user\n\n**v1.0.5 Changelog:**\n\n- Added English and Chinese README files for better documentation (README.en.md, README.md).\n- Removed outdated documentation file (skill-card.md).\n- Updated and expanded SKILL.md:\n    - Improved feature and usage instructions with detailed scenarios and step-by-step guides.\n    - Clarified environment variable/API key setup and installation for different platforms.\n    - Enhanced FAQ, output specification, and workflow guidance.\n    - Provided clearer module structure overview and execution constraints.\n\nv1.0.4 | 2026-05-15T03:51:02.806Z | user\n\n- Removed file: _skillhub_meta.json\n- No user-facing features or workflow changed.\n- Minor cleanup to project files.\n\nv1.0.3 | 2026-05-08T11:25:08.660Z | user\n\nxhs-daily-ranking 1.0.3\n\n- 更新了技能描述，突出支持多分类查询、单日爆款笔记分析、趋势追踪与创作灵感提炼。\n- 其余功能、输出规范与用法保持一致。\n\nv1.0.2 | 2026-04-29T12:28:35.655Z | user\n\nxhs-daily-ranking 1.0.2\n\n- 简化/收敛高级用法描述，分类匹配规则仅在内部执行，不再直接向用户展示映射细节。\n- 删除/精简部分场景、收益等表述，调整表格内容结构。\n- 保持所有功能点、输出规范和命令一致，无功能变更。\n- 其他文档细节优化，提升可读性和简洁性。\n\nv1.0.1 | 2026-04-29T11:39:26.390Z | user\n\n- 更新了完整功能流程参考文档路径，从 assets/core_workflow.md 移动到 references/core_workflow.md\n- 对相关文档链接和资源索引进行了相应调整\n- 移除了无效的 assets/core_workflow.md 引用\n- 其余功能与使用方式不变\n\nv1.0.0 | 2026-04-29T09:25:00.817Z | user\n\nxhs-daily-ranking 1.0.0 — 首发版本，提供小红书单日爆发榜查询与数据分析能力。\n\n- 支持查询小红书平台当日TOP50爆款笔记，按25大分类快速检索\n- 自动生成3项分析报告及可视化HTML页面，Markdown/HTML多格式输出\n- 提供每日19:30榜单订阅推送，无需小红书账号或API密钥\n- 可按关键词/分类/日期精准检索并导出爆文数据\n- 内置命令、使用场景与完整输出规范，便于内容创作者与运营分析使用\n\nArchive index:\n\nArchive v1.0.5: 9 files, 52155 bytes\n\nFiles: README.en.md (5548b), README.md (4519b), references/core_workflow.md (28724b), scripts/gen_xhs_html.py (35123b), scripts/xhs_daily_fetcher.py (28984b), scripts/xhs_weekly.html (37728b), skill-card.md (2771b), SKILL.md (13569b), _meta.json (136b)\n\nFile v1.0.5:SKILL.md\n\n---\r\nname: xiaohongshu-dailytop\r\ndescription: 小红书每日爆款笔记是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。\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- **各领域当日趋势追踪**：监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。\r\n- **创作灵感生成**：基于当日爆款内容，提炼可复用的选题、话术与呈现形式，直接用于你的下一篇笔记策划。\r\n\r\n适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。\r\n---\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n- **🔥 单日爆发榜查询**：获取当日热门笔记TOP50，按分类查询，支持25个垂直领域精准匹配\r\n- **📊 智能规律分析**：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告\r\n- **📈 多维度数据展示**：完整呈现互动数、点赞、评论、收藏、分享及新增数据\r\n- **🔔 自动订阅推送**：支持每日19:30固定时间推送最新榜单到消息栏\r\n\r\n### ✨ 特色亮点\r\n\r\n- **🏷️ 全分类覆盖**：综合全部、化妆美容、时尚穿搭、美味佳肴等 25 个主流分类\r\n- **🔍 智能分类匹配**：输入「睫毛膏」→ 化妆美容，无需手动选类（对用户不展示匹配结果）\r\n- **⏰ 灵活日期适配**：支持指定日期；未指定时按 19:00 更新规则自动判断查询日\r\n- **📄 双格式输出**：Markdown 表格 + 按需生成 HTML 页面，自用与汇报均可\r\n\r\n---\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n\r\n- Python 3.8 及以上\r\n- `requests`：`pip install requests`\r\n- [红狐Hub](https://redfox.hk/) 账号与 API Key（格式 `ak_xxxxxxxx`，新用户注册赠免费积分）\r\n\r\n### 安装方式\r\n\r\n#### SkillHub / ClawHub（推荐）\r\n\r\n1. 前往 [SkillHub](https://skillhub.cn) 或 [ClawHub](https://clawhub.ai)\r\n2. 搜索 **xiaohongshu-dailytop** 或 **小红书每日爆款笔记**\r\n3. 按平台指引安装技能包\r\n4. 在对话环境或本机配置 `REDFOX_API_KEY`（见下方）\r\n\r\n#### WorkBuddy / 龙虾（本地技能）\r\n\r\n1. 将本技能目录放入 WorkBuddy 的 `skills` 路径（如 `~/.workbuddy/skills/xiaohongshu-dailytop`）\r\n2. 在对话中通过技能名或描述触发（如「查小红书每日爆款笔记」「睫毛膏爆款」）\r\n3. 配置 `REDFOX_API_KEY` 后重启终端，确保 Agent 与脚本均可读取\r\n\r\n#### 命令行独立使用\r\n\r\n```bash\r\npip install requests\r\ncd xiaohongshu-dailytop\r\n# 步骤一：获取数据并写入缓存\r\npython scripts/xhs_daily_fetcher.py --keyword \"睫毛膏\" --top_n 50 --output_json /tmp/xhs_daily_cache.json\r\n# 步骤二：从缓存生成 HTML（跳过 API 调用）\r\npython scripts/gen_xhs_html.py --keyword \"睫毛膏\" --top 20 --input_json /tmp/xhs_daily_cache.json\r\n```\r\n\r\n### 环境变量配置\r\n\r\n| 变量名 | 必填 | 说明 |\r\n| --- | --- | --- |\r\n| `REDFOX_API_KEY` | 是 | 红狐 API 密钥，格式 `ak_xxxxxxxx` |\r\n\r\n**获取 API Key**：访问 [红狐Hub官网](https://redfox.hk/) → [注册/登录](https://redfox.hk/login) → 个人中心复制 Key。\r\n\r\n**macOS / Linux**：\r\n\r\n```bash\r\necho 'export REDFOX_API_KEY=<你的apikey>' >> ~/.zshrc\r\nsource ~/.zshrc\r\n```\r\n\r\n**Windows**（PowerShell）：\r\n\r\n```powershell\r\n[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<你的apikey>\", \"User\")\r\n```\r\n\r\n验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows）。未生效请重启终端。\r\n\r\n**Windows Git Bash 注意事项**：PowerShell 设置的用户级环境变量 Git Bash 可能无法读取，需在命令中显式注入：\r\n```bash\r\nexport REDFOX_API_KEY=\"ak_xxx\" && python scripts/xhs_daily_fetcher.py ...\r\n```\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n### 基础使用\r\n\r\n#### 1. 发起查询\r\n\r\n告诉助手关键词或领域（未指定分类则自动匹配，未指定日期则按 19:00 规则判断）：\r\n\r\n> 用户：帮我查一下睫毛膏相关的爆款笔记\r\n>\r\n> 助手：依次输出每日爆款笔记 TOP20、每日爆款笔记分析、功能服务询问\r\n\r\n#### 2. 查看更多\r\n\r\n默认 TOP20；数据超过 20 条时可回复「查看更多」：\r\n\r\n> 用户：查看更多\r\n>\r\n> 助手：展示 TOP21 至榜单末尾\r\n\r\n#### 3. 生成 HTML 文件包\r\n\r\n在功能服务询问后，回复\"2\"或\"生成\"：\r\n\r\n> 用户：2\r\n>\r\n> 助手：生成小红书风格的 HTML 文件包，支持导出 PDF\r\n\r\n#### 4. 订阅推送\r\n\r\n在功能服务询问后，回复\"1\"或\"订阅\"：\r\n\r\n> 用户：1\r\n>\r\n> 助手：已开通每日 19:30 推送小红书每日爆款笔记 TOP50\r\n\r\n### 高级使用\r\n\r\n#### 1. 指定日期查询\r\n\r\n> 用户：查 2026-04-20 美妆类每日爆款笔记\r\n\r\n#### 2. 泛查询热门内容\r\n\r\n> 用户：最近小红书有什么热门内容\r\n\r\n（未指定关键词时使用「综合全部」分类。）\r\n\r\n#### 3. 指定分类查询\r\n\r\n> 用户：查时尚穿搭分类昨天的爆发榜\r\n\r\n#### 4. 取消订阅\r\n\r\n> 用户：取消订阅\r\n\r\n### 常用命令速查\r\n\r\n| 命令 / 用户说法 | 功能 |\r\n| --- | --- |\r\n| `查[关键词]爆款` / `每日爆款笔记` | 按关键词查询当日爆发榜（默认 TOP20） |\r\n| `查[日期] [分类/关键词]爆款` | 指定日期或分类查询 |\r\n| `查看更多` | 展示 TOP21–末尾 |\r\n| `1` / `订阅` | 开通每日 19:30 TOP50 推送 |\r\n| `2` / `生成` | 生成小红书风格 HTML 文件包 |\r\n| `python scripts/xhs_daily_fetcher.py --keyword \"睫毛膏\" --top_n 50 --output_json /tmp/cache.json` | 命令行拉取榜单数据并写入缓存 |\r\n| `python scripts/gen_xhs_html.py --keyword \"睫毛膏\" --top 20 --input_json /tmp/cache.json` | 命令行从缓存生成 HTML（跳过 API） |\r\n\r\n**Agent 执行说明**：完整输出顺序、表格格式、功能服务询问文案等硬性约束见 [references/core_workflow.md](references/core_workflow.md)。\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\r\n1. 输入赛道关键词（如「化妆美容」「穿搭」）查询每日爆款笔记\r\n2. 阅读「爆款标题分析」「最高数据作品分析」提炼可复制结构\r\n3. 导出 HTML 为 PDF 留存参考\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\r\n1. 按品类关键词每日查询爆发榜 TOP20\r\n2. 对比互动、收藏、分享新增数据筛选高转化笔记\r\n3. 订阅每日 19:30 推送，持续跟踪赛道变化\r\n\r\n**预期收益**：热点响应更及时，内容策略与平台节奏对齐\r\n\r\n---\r\n\r\n### 场景三：MCN 挖掘潜力笔记与账号\r\n\r\n**角色**：MCN 内容星探\r\n\r\n**需求**：发现低粉高互动的爆发笔记，评估签约价值\r\n\r\n**使用方式**：\r\n\r\n1. 查看榜单中作者粉丝数与互动新增对比\r\n2. 结合「最高互动作品分析」判断账号成长潜力\r\n3. 使用 HTML 内链接跳转原文与作者主页二次核实\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\r\n1. 指定日期拉取目标分类 TOP50（先 TOP20，再「查看更多」）\r\n2. 将 HTML 导出 PDF 纳入日报\r\n3. 基于「热门内容分析」归纳封面、选题、热点结合等共性\r\n\r\n**预期收益**：数据口径统一，复盘与汇报材料一键生成\r\n\r\n---\r\n\r\n## 项目架构\r\n\r\n### 目录结构\r\n\r\n```\r\nxiaohongshu-dailytop/\r\n├── SKILL.md                    # 产品说明（本文档）\r\n├── references/\r\n│   └── core_workflow.md        # Agent 执行流程、输出规范、分类与日期规则\r\n└── scripts/\r\n    ├── xhs_daily_fetcher.py    # 调用 API 获取榜单数据\r\n    ├── gen_xhs_html.py         # 生成可视化 HTML 页面\r\n    └── xhs_weekly.html         # HTML 模板资源\r\n```\r\n\r\n### 技术栈\r\n\r\n| 项目 | 说明 |\r\n| --- | --- |\r\n| 运行环境 | Python 3.8+ |\r\n| 核心依赖 | `requests` |\r\n| 数据来源 | 红狐 API `getXhsCozeSkillDataOne` |\r\n| 鉴权 | 请求头 `X-API-KEY` ← 环境变量 `REDFOX_API_KEY` |\r\n| 部署方式 | SkillHub / ClawHub / WorkBuddy 本地技能 / 命令行 |\r\n\r\n### 核心模块\r\n\r\n| 模块 | 职责 |\r\n| --- | --- |\r\n| `xhs_daily_fetcher.py` | 关键词匹配分类、日期判断、调用 API、输出榜单数据；支持 `--output_json` 写入 JSON 缓存供 gen_html 复用 |\r\n| `gen_xhs_html.py` | 优先从 `--input_json` 缓存读取数据生成 HTML（跳过 API 调用），缓存无效时回退到独立 API；支持 `--top 20/50` |\r\n| `core_workflow.md` | 四段强制输出、表格/HTML 格式、订阅文案、分类列表、接口调用上限与数据复用规则 |\r\n\r\n---\r\n\r\n## 常见问答\r\n\r\n### 安装相关问题\r\n\r\n**Q1：提示未找到 `REDFOX_API_KEY` 怎么办？**\r\n\r\n按 [一键安装](#一键安装) 注册 红狐Hub官网 并配置环境变量；配置后重启终端。若用户不会配置，Agent 应协助写入 `~/.zshrc` / `~/.bashrc` 或 Windows 用户级环境变量。\r\n\r\n**Q2：如何验证 API Key 已生效？**\r\n\r\n执行 `echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确认以 `ak_` 开头。\r\n\r\n**Q3：支持哪些安装/调用方式？**\r\n\r\nSkillHub、ClawHub、WorkBuddy 本地技能目录，或直接运行 `scripts/` 下 Python 脚本。\r\n\r\n---\r\n\r\n### 使用相关问题\r\n\r\n**Q4：榜单数据每天何时更新？**\r\n\r\n每日 **19:00** 更新**昨日**数据。当前时间 ≥ 19:00 查昨日；< 19:00 查前天（未指定日期时）。\r\n\r\n**Q5：「每日爆款笔记」指标含义是什么？**\r\n\r\n笔记发布后**第 3 天相对第 2 天**的互动增量由高到低排序的 TOP50，不是累计总榜。\r\n\r\n**Q6：为什么只显示 20 条？**\r\n\r\n首次默认 TOP20；返回超过 20 条时回复「查看更多」可加载剩余，HTML 同步扩展为全量。\r\n\r\n**Q7：一次查询会输出哪些内容？**\r\n\r\n固定三部分：每日爆款笔记 → 每日爆款笔记分析（3 模块）→ 功能服务询问。HTML 文件包按需生成。顺序与格式以 [core_workflow.md](references/core_workflow.md) 为准。\r\n\r\n---\r\n\r\n### 安全与许可\r\n\r\n**Q8：API Key 如何保管？**\r\n\r\n仅通过环境变量读取，勿提交至公开仓库或聊天记录。\r\n\r\n**Q9：数据使用边界？**\r\n\r\n榜单以 API/脚本成功返回为准；跳转原文须遵守小红书平台规则与版权要求，不对未验证数据做夸大承诺。\r\n\r\n### 接口调用优化\r\n\r\n**Q10：一次查询会调用几次 API？**\r\n\r\n正常有数据场景仅 **1 次**（fetcher 获取数据并写入缓存，gen_html 从缓存读取跳过 API）。默认日期无数据时脚本内置回退一天，最多 2 次。Agent 禁止在脚本之外自行构造 API 请求。\r\n\r\n**Q11：gen_html 能否跳过 API 直接使用缓存？**\r\n\r\n可以。使用 `--input_json` 参数指定 fetcher 输出的 JSON 缓存文件，gen_html 将完全跳过 API 调用，即使没有 API Key 也能正常生成 HTML。\r\n\r\n---\r\n\r\n## 核心工作流程\r\n\r\n完整执行规范（触发前提、输出、表格/HTML 模板、功能服务询问原文、分类匹配、日期规则、脚本参数）**必须先读取并遵循** [references/core_workflow.md](references/core_workflow.md)，并**完整遵循**其中的触发规则、输出规范、操作步骤与注意事项。脚本路径相对于技能目录：`scripts/xhs_daily_fetcher.py`、`scripts/gen_xhs_html.py`。\r\n\r\n\r\n执行任务时须严格遵循，包括但不限于：\r\n\r\n- 禁止在用户未明确查询或未订阅时自动拉榜\r\n- 必须按顺序输出：爆发榜 → 分析 → 功能服务询问\r\n- 禁止折叠输出；禁止输出 CSV/JSON 等文件\r\n- 表格与 HTML 数据源、顺序必须一致\r\n- HTML 按需生成，文件名格式：小红书每日爆款笔记_{分类}_唯一时间戳.html\r\n\r\n## 注意事项\r\n\r\n- **数据时效**：每日 19:00 更新；查询日期规则见核心流程\r\n- **输出完整性**：三部分缺一不可；功能服务询问须在每日分析之后立即原样输出\r\n- **数据真实性**：以脚本/API 返回为准，禁止幻觉补齐排名或互动数\r\n- **合规**：遵守平台与版权规范；订阅推送时间为每日 19:30\n\nFile v1.0.5:README.md\n\n# 小红书每日爆款笔记 / xiaohongshu-dailytop\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- 支持每日 19:30 订阅推送，持续跟踪赛道热点变化\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- **单日爆发榜查询**：获取当日热门笔记 TOP50，支持 25 个垂直领域精准匹配\r\n- **智能规律分析**：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告\r\n- **多维度数据展示**：完整呈现互动数、点赞、评论、收藏、分享及新增数据\r\n- **自动订阅推送**：支持每日 19:30 固定时间推送最新榜单\r\n\r\n### 特色亮点\r\n\r\n- 输入「睫毛膏」自动匹配「化妆美容」分类，无需手动选类\r\n- 首次输出 TOP20，回复「查看更多」加载剩余，HTML 同步扩展为全量\r\n- 榜单表格与 HTML 页面数据来源、顺序完全一致\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\r\n- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。\r\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\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| ------------ | ---------------------------------- | ----------------------------------------------------------------- |\r\n| 查当日爆款   | `帮我查一下睫毛膏相关的爆款笔记`   | 自动匹配分类，输出当日爆发榜 TOP20 + 三维度分析 + HTML + 订阅选项 |\r\n| 查泛热门内容 | `最近小红书有什么热门内容`         | 使用「综合全部」分类查询，完整四段输出                            |\r\n| 查指定日期   | `查 2026-04-20 美妆类每日爆款笔记` | 指定日期查询对应分类单日爆发榜                                    |\r\n| 加载更多     | 回复「查看更多」                   | 展示 TOP21 至末尾，HTML 同步刷新为全量数据                        |\r\n| 订阅推送     | 输出完成后回复 `1`                 | 开通每日 19:30 推送小红书每日爆款笔记 TOP50                       |\r\n\r\n### 输出示例\r\n\r\n每次查询固定四段输出：每日爆款笔记榜单 → 三维度规律分析 → HTML 可视化页面 → 订阅服务选项。\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景         | 角色            | 示例问法                                 | 收益                                                   |\r\n| ------------ | --------------- | ---------------------------------------- | ------------------------------------------------------ |\r\n| 每日爆款灵感 | 美妆 / 穿搭博主 | `查一下今天化妆美容爆款笔记`             | 提炼当日爆款标题结构与内容特征，直接用于下一篇笔记策划 |\r\n| 当日热点追踪 | 品牌小红书运营  | `订阅穿搭类每日爆款推送`                 | 持续跟踪赛道变化，热点响应更及时                       |\r\n| 潜力笔记挖掘 | MCN 内容星探    | `今天美食类有哪些低粉高互动的爆发笔记？` | 结合互动新增数据发现成长型账号                         |\r\n| 每日数据复盘 | 增长 / 数据分析 | `查今天科技类 TOP50 并导出 HTML`         | 导出 PDF 纳入日报，数据口径统一可存档                  |\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"xhs-daily-ranking\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1780630387637\n}\n\nFile v1.0.5:references/core_workflow.md\n\n# 小红书每日爆款笔记 · 核心工作流程\r\n\r\n> Agent 执行本技能时须完整遵循本文档。用户向导读见 [SKILL.md](../SKILL.md)。\r\n\r\n## 任务目标\r\n\r\n- 本 Skill 用于：获取小红书平台爆款内容榜单数据\r\n- 能力包含：\r\n  - 每日爆款笔记数据获取（按分类查询）\r\n  - 每日爆款笔记智能分析\r\n  - 冷门爆款笔记挖掘（关键词匹配分类）\r\n  - 订阅服务（每日定时推送）\r\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\r\n\r\n## 数据接口更新规则\r\n\r\n- **更新时间**：每天19:00更新昨天的榜单数据\r\n- **数据范围**：当日的热门笔记TOP50\r\n- **分类覆盖**：25个垂直领域分类\r\n- **接口地址**：`https://redfox.hk/story/api/cozeSkill/getXhsCozeSkillDataOne`\r\n- **请求方式**：**GET**（query 参数：`rankDate`、`source`、`category`）；**禁止使用 POST**（会返回系统内部错误）\r\n- **认证方式**：请求头 `X-API-KEY`，从环境变量 `REDFOX_API_KEY` 获取；脚本通过 `requests.get` 发起请求\r\n\r\n## 鉴权\r\n\r\n### 获取 API Key\r\n\r\n1. 访问 [RedFox 官网](https://redfox.hk/) 了解服务详情\r\n2. 前往 [注册页面](https://redfox.hk/login) 注册账号\r\n3. **新注册用户将获赠免费积分**，可立即开始使用 API 服务\r\n4. 注册登录后，在个人中心获取 API Key，格式为 `ak_xxxxxxxx`\r\n\r\n### 配置 API Key\r\n\r\n- `REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`\r\n- 若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若用户不会配置，Agent 应主动帮用户设置：\r\n  - **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效\r\n  - **Windows**：使用 `[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<值>\", \"User\")` 设置用户级永久环境变量（需重启终端生效）\r\n  - 配置完成后应验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确保换一个 skill 也能读取到\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- 每日爆款笔记表格与HTML页面数据必须完全一致（相同顺序、相同内容）\r\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\r\n- 禁止胡乱渲染或使用不同数据源\r\n\r\n**输出内容必须严格包含以下三部分，禁止遗漏或胡乱输出：**\r\n\r\n- **每日爆款笔记（更新时间）**：必须直接输出，禁止折叠，禁止遗漏\r\n- **每日爆款笔记分析**：必须直接输出，禁止折叠，禁止遗漏\r\n- **功能服务询问**：必须在每日分析之后强制输出，禁止跳过，禁止遗漏，禁止等待用户回复\r\n\r\n**输出格式要求（强制执行）**：\r\n\r\n- **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\r\n- **禁止输出文件**：禁止输出任何其他文件（如CSV、JSON、TXT等）\r\n- **输出顺序**：严格按照每日爆款笔记 → 每日分析 → 功能服务询问的顺序执行，禁止混乱输出\r\n- **HTML页面改为按需生成**：不再强制自动生成HTML，改为在功能服务询问中让用户选择是否生成。用户回复\"2\"或\"生成\"后才执行 gen_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）**（标题整体加粗）\r\n- 标题示例：**🔥 【化妆美容】每日爆款笔记 （更新时间：2026-04-21 19:00）**\r\n\r\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\r\n\r\n| 排名 | 笔记信息                                         |      互动数       |       点赞        |       评论       |       收藏       |       分享        |\r\n| :--: | :----------------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\r\n|  🥇  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 22w+<br>↑新增23w+ | 22w+<br>↑新增21w+ | 893<br>↑新增21w+ | 1w+<br>↑新增21w+ | 1w+<br>↑新增21w+  |\r\n|  🥈  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 20w+<br>↑新增18w+ | 18w+<br>↑新增16w+ | 756<br>↑新增18w+ | 8k+<br>↑新增16w+ | 900+<br>↑新增16w+ |\r\n|  🥉  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 18w+<br>↑新增15w+ | 15w+<br>↑新增13w+ | 621<br>↑新增15w+ | 7k+<br>↑新增13w+ | 800+<br>↑新增13w+ |\r\n\r\n**字段详细说明**：\r\n\r\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\r\n- **笔记信息**：\r\n  - 第一行：笔记标题（可点击跳转）\r\n  - 第二行：[作者名](作者主页链接) 粉丝数+（作者名可点击跳转到作者主页，链接使用API返回的userJumpUrl字段，字号与标题一样大）\r\n- **互动数**：\r\n  - 第一行：累计互动数（格式：数字w+ 或 纯数字）\r\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\r\n- **点赞**：\r\n  - 第一行：累计点赞数（格式：数字w+ 或 纯数字）\r\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\r\n- **评论**：\r\n  - 第一行：累计评论数（格式：数字w+ 或 纯数字）\r\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\r\n- **收藏**：\r\n  - 第一行：累计收藏数（格式：数字w+ 或 纯数字）\r\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\r\n- **分享**：\r\n  - 第一行：累计分享数（格式：数字w+ 或 纯数字）\r\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\r\n  - **分享字段必须展示且不能出错**\r\n\r\n**重要说明**：\r\n\r\n- 使用标准 Markdown 表格格式\r\n- 单元格内使用 `<br>` 换行显示累计数据和新增数据\r\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\r\n- 新增数据格式：累计数据 <br> ↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\r\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\r\n- \"↑新增\"文案字号比累计数据小一号\r\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\r\n\r\n**数据说明（必须在表格上方、标题之后输出）**：\r\n\r\n- 在每日爆款笔记标题之后、表格之前输出：_每日爆款笔记指笔记发后第3天比第2天涨的数据由高到低Top50_\r\n\r\n**数据输出逻辑（必须严格执行）**：\r\n\r\n- **首次输出**：\r\n  - 每日爆款笔记表格：显示TOP1到TOP20\r\n  - HTML页面：显示TOP1到TOP20（与热榜表格保持一致）\r\n  - **\"查看更多\"提示逻辑**（必须严格执行）：\r\n    - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\r\n    - 如果返回数据 > 20条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"（显示剩余数据条数）\r\n    - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\r\n- **用户输入\"查看更多\"后**：\r\n  - 每日爆款笔记表格：输出TOP21到实际数据末尾（延续之前的TOP20）\r\n  - HTML页面：输出TOP1到实际数据末尾（完整数据，覆盖之前的HTML文件）\r\n\r\n### 第二部分：每日爆款笔记分析\r\n\r\n**输出要求**：\r\n\r\n- 必须直接完整输出3个模块内容（热门内容分析、爆款标题分析、最高数据作品分析）\r\n- 禁止折叠、隐藏或展开任何模块\r\n- 禁止输出为文件格式\r\n- 所有分析内容都基于获取到的所有数据\r\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\r\n- **必须包含3个模块，禁止遗漏**\r\n\r\n- 标题格式：**📊 每日爆款笔记分析**（加粗，不带Top数量）\r\n- 示例：**📊 每日爆款笔记分析**\r\n\r\n以下内容分析基于获取的全部数据（共{数据条数}条）进行~\r\n\r\n**💡热门内容分析**\r\n\r\n| 内容分类 | 内容特征                                                                                                                                                                           | 实际效果      | 参考笔记                           |\r\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\r\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]<br>[笔记标题链接2] |\r\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望                           | 互动率提升50% | [笔记标题链接3]<br>[笔记标题链接4] |\r\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查                         | 收藏率提升55% | [笔记标题链接5]<br>[笔记标题链接6] |\r\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力                                     | 曝光率提升40% | [笔记标题链接7]<br>[笔记标题链接8] |\r\n\r\n**📈爆款标题分析**\r\n\r\n| 标题类型 | 标题特征                                                                                                           | 标题模版         | 发布规律             | 参考标题                 |\r\n| :------- | :----------------------------------------------------------------------------------------------------------------- | :--------------- | :------------------- | :----------------------- |\r\n| 提问式   | 标题以疑问句开头，设置悬念或提出用户关心的问题，引发用户的好奇心和思考欲望，激发点击阅读或评论互动                 | \"你还在XX吗？\"   | 工作日早高峰效果最佳 | 这个方法你还在用吗？     |\r\n| 数字式   | 标题中包含具体的数字、数量或统计数据，利用人们对量化信息的偏好，增强内容的可信度和专业感，让用户觉得内容有价值     | \"XX个XX技巧\"     | 午餐时间点击率高     | 5个快速提升XX的技巧      |\r\n| 情绪词   | 使用具有强烈情感色彩的词汇或网络流行语，如\"绝了\"、\"太XX了\"等，直接触发用户的情绪反应，引发点赞、评论或分享行为     | \"太XX了！忍不住\" | 晚间黄金时段转化高   | 太好用了！忍不住分享给你 |\r\n| 利益点   | 直接在标题中明确承诺用户可以获得的具体利益或效果，如\"XX天就能XX\"、\"省XX元\"等，降低用户决策成本，提高点击率和收藏率 | \"XX天就能XX\"     | 深夜发布收藏率最高   | 7天就能看到明显效果      |\r\n\r\n**✨最高数据作品分析**\r\n\r\n| 维度     | 核心特征分析                                               | 参考笔记       |\r\n| :------- | :--------------------------------------------------------- | :------------- |\r\n| 最高点赞 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\r\n| 最高收藏 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\r\n| 最高评论 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\r\n| 最高互动 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\r\n\r\n### 第三部分：功能服务询问（每日分析之后输出，禁止跳过）\r\n\r\n**强制要求（必须严格遵守）**：\r\n\r\n- 功能服务询问是输出内容的第3部分，必须在每日爆款笔记分析之后立即输出\r\n- **禁止跳过，禁止遗漏，禁止等待用户回复**\r\n- **禁止折叠输出**\r\n\r\n**功能服务询问内容（必须原样输出，禁止修改，禁止省略）**：\r\n\r\n```\r\n技能还支持以下功能：\r\n1️⃣ 支持订阅小红书每日爆款笔记。订阅后将在每日19:30为您推送小红书每日爆款笔记TOP50。直接回复\"订阅或 1\"即可订阅相关内容。\r\n2️⃣ 可生成小红书风格的html文件包。支持导出PDF，方便阅读、保存和分享。\r\n\r\n回复对应的数字即可。\r\n```\r\n\r\n**功能响应逻辑**：\r\n\r\n- 用户回复\"1\"或\"订阅\" → 开通每日19:30推送小红书每日爆款笔记TOP50\r\n- 用户回复\"2\"或\"生成\" → 执行HTML生成脚本，生成HTML文件包\r\n\r\n### HTML页面生成（用户回复\"2\"后执行）\r\n\r\n**执行命令**：\r\n\r\n- **首次输出**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\r\n- **用户输入\"查看更多\"后**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50`\r\n\r\n**HTML文件命名规则**：\r\n\r\n- 文件名格式：`小红书每日爆款笔记_{分类}_唯一时间戳.html`\r\n- 唯一时间戳格式：`YYYYMMDD_HHmmss`（精确到秒，确保每次生成文件名唯一）\r\n- 示例：`小红书每日爆款笔记_日常生活_20260528_144500.html`\r\n\r\n**文件特点**：\r\n\r\n- 可独立打开的HTML文件\r\n- 支持直接点击链接跳转\r\n- 支持导出图片和PDF功能（导出结果与页面显示完全一致，PDF和图片导出内容一定是正确的）\r\n- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为\"↑新增数值\"格式，整体字号增大1px\r\n- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据，分享字段必须展示且不能出错）\r\n\r\n## 数据输出逻辑详解\r\n\r\n**核心原则**：\r\n\r\n- 每日爆款笔记表格与HTML页面必须保持数据一致性\r\n- 使用相同的API接口，禁止修改接口返回的顺序\r\n\r\n### 阶段一：首次输出\r\n\r\n1. **每日爆款笔记表格**：\r\n   - 调用脚本获取数据（最多50条）\r\n   - 展示TOP1到TOP20（前20条）\r\n   - **\"查看更多\"提示逻辑（根据实际数据量动态调整）**：\r\n     - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\r\n     - 如果返回数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{实际剩余数量}条！✨\"\r\n     - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\r\n\r\n2. **每日爆款笔记分析**：\r\n   - 基于获取的全部数据进行分析，输出3个模块\r\n\r\n3. **功能服务询问**：\r\n   - 在每日分析后立即输出功能服务询问文案\r\n   - 等待用户回复数字选择功能\r\n\r\n4. **HTML页面（用户回复\"2\"后执行）**：\r\n   - 执行命令：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\r\n   - 生成HTML文件，包含TOP1到TOP20数据\r\n   - 与每日爆款笔记表格数据完全一致\r\n   - 文件名格式：`小红书每日爆款笔记_{分类}_YYYYMMDD_HHmmss.html`\r\n\r\n### 阶段二：用户输入\"查看更多\"\r\n\r\n1. **每日爆款笔记表格**：\r\n   - 继续展示TOP21到实际数据末尾（根据实际数据量）\r\n   - 延续首次输出的数据，不重复TOP1-20\r\n\r\n2. **HTML页面**：\r\n   - 执行命令：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50`\r\n   - 文件名格式：`小红书每日爆款笔记_{分类}_YYYYMMDD_HHmmss.html`\r\n\r\n### 数据一致性保障\r\n\r\n- 两个脚本使用相同的API接口\r\n- 相同的API接口，禁止修改接口返回的顺序\r\n- 相同的数据字段和格式\r\n- 确保表格和HTML页面的排名、数据完全一致（禁止修改接口返回的顺序）\r\n\r\n## 操作步骤\r\n\r\n### 标准流程\r\n\r\n#### 第一步：分类匹配\r\n\r\n根据用户输入自动匹配合适的分类：\r\n\r\n**可用分类列表（共25个）**：\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穿搭/衣服/时尚 → 时尚穿搭\r\n美食/做饭/探店 → 美味佳肴\r\n猫/狗/宠物 → 宠物天地\r\n游戏/王者/电竞 → 休闲娱乐\r\n```\r\n\r\n#### 第二步：查询冷门爆款笔记\r\n\r\n- 用户输入关键词后，自动匹配对应分类（**不告知用户匹配到的分类名称**）\r\n- 查询该分类下的冷门爆款笔记（最多50条）\r\n- **根据实际数据量动态展示**：\r\n  - 如果返回数据 ≤ 20条：默认展示全部数据，不展示\"查看更多\"提示\r\n  - 如果返回数据 > 20条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余{数量}条！✨\"提示\r\n  - 如果返回数据 = 50条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余30条！✨\"提示\r\n\r\n#### 第三步：日期判断\r\n\r\n根据用户输入和当前时间确定查询日期：\r\n\r\n**判断规则**：\r\n\r\n1. **用户指定了日期** → 直接使用指定日期\r\n2. **用户未指定日期**：\r\n   - 当前时间 >= 19:00 → 查询**昨日**数据（当日19:00已更新）\r\n   - 当前时间 < 19:00 → 查询**前天**数据（等待当日19:00更新）\r\n\r\n#### 第四步：获取每日爆款笔记数据\r\n\r\n**API Key 前置检查（强制）**：\r\n\r\n- 调用脚本前，必须先确认 `REDFOX_API_KEY` 环境变量已正确配置\r\n- Windows 环境：Git Bash 可能无法读取 PowerShell 设置的用户级环境变量，需在命令中显式 `export`\r\n- 验证方式：`export REDFOX_API_KEY=\"ak_xxx\"` 后再执行脚本，或先执行 `echo $REDFOX_API_KEY` 确认非空\r\n- 若 Key 缺失，直接提示用户配置并终止，**禁止进入多轮调试**\r\n\r\n调用脚本获取榜单数据，**必须携带 `--output_json` 参数**写入缓存：\r\n\r\n```bash\r\nexport REDFOX_API_KEY=\"ak_xxx\" && python scripts/xhs_daily_fetcher.py --keyword \"睫毛膏\" --top_n 50 --output_json /tmp/xhs_daily_cache.json\r\n```\r\n\r\n**参数说明**：\r\n\r\n- `--category`：分类名称（可选）\r\n- `--keyword`：用户输入的关键词，用于自动匹配分类\r\n- `--rank_date`：查询日期（可选，自动判断）\r\n- `--top_n`：返回条数（默认50）\r\n- `--output_json`：**必须指定**，数据获取成功后写入 JSON 缓存，供 gen_html 复用\r\n\r\n**无数据回退规则（强制）**：\r\n\r\n- 当默认日期返回 0 条数据时，脚本内置自动回退一天，**Agent 无需手动重试**\r\n- **最多尝试 2 个日期**（默认日期 + 回退一天），若仍无数据则直接告知用户该分类暂无数据\r\n- 禁止用循环方式批量探测日期\r\n\r\n**数据完整性要求**：\r\n\r\n- 确保表格所有字段和数据完整加载\r\n- 如果数据加载失败或字段缺失，重新调用脚本再次尝试（**最多重试 1 次**）\r\n- 直到所有字段（排名、笔记信息、互动数、点赞、评论、收藏、分享）都有完整数据\r\n- **分享字段使用正确的API字段名**：`AnaAddBean.useShareCount`（累计分享数）、`AnaAddBean.addShareCount`（新增分享数）\r\n- **确保分享数值正确输出，避免使用错误的字段名导致数值不对**\r\n\r\n**接口调用上限（强制）**：\r\n\r\n- 正常流程最多调用 **1 次**接口（fetcher 一次获取 + 回退由脚本内置处理）\r\n- HTML 生成**禁止独立调用接口**，必须从缓存读取\r\n- **禁止 Agent 在脚本之外自行构造 API 请求排查问题**\r\n- 整个查询流程总接口调用次数上限：**2 次**（含脚本内置回退）\r\n\r\n#### 第五步：输出每日爆款笔记和每日分析\r\n\r\n按照输出规范，依次输出：\r\n\r\n1. 每日爆款笔记（含更新时间）\r\n2. 每日爆款笔记分析（3个模块）\r\n\r\n#### 第六步：输出功能服务询问（3项输出中的第3项）\r\n\r\n**重要要求：每日分析输出完成后必须立即执行此步**\r\n\r\n输出功能服务询问文案（原样输出，禁止修改，禁止省略）：\r\n\r\n```\r\n技能还支持以下功能：\r\n1️⃣ 支持订阅小红书每日爆款笔记。订阅后将在每日19:30为您推送小红书每日爆款笔记TOP50。直接回复\"订阅或 1\"即可订阅相关内容。\r\n2️⃣ 可生成小红书风格的html文件包。支持导出PDF，方便阅读、保存和分享。\r\n\r\n回复对应的数字即可。\r\n```\r\n\r\n**响应逻辑**：\r\n- 用户回复\"1\"或\"订阅\" → 开通订阅，每日19:30推送\r\n- 用户回复\"2\"或\"生成\" → 执行第七步生成HTML\r\n\r\n#### 第七步：生成HTML页面（用户回复\"2\"后执行）\r\n\r\n**仅在用户明确回复\"2\"或\"生成\"时才执行此步，不自动生成**\r\n\r\n生成可视化HTML页面。**必须使用 `--input_json` 从缓存读取数据，禁止独立调用 API**。\r\n\r\n**首次输出时**：\r\n\r\n```bash\r\nexport REDFOX_API_KEY=\"ak_xxx\" && python scripts/gen_xhs_html.py --keyword \"穿搭\" --top 20 --input_json /tmp/xhs_daily_cache.json --rank_date \"YYYY-MM-DD\" --output \"小红书每日爆款笔记_穿搭_20260528_144500.html\"\r\n```\r\n\r\n**用户输入\"查看更多\"后**：\r\n\r\n```bash\r\nexport REDFOX_API_KEY=\"ak_xxx\" && python scripts/gen_xhs_html.py --keyword \"穿搭\" --top 50 --input_json /tmp/xhs_daily_cache.json --rank_date \"YYYY-MM-DD\" --output \"小红书每日爆款笔记_穿搭_20260528_144500.html\"\r\n```\r\n\r\n**HTML文件命名规则（强制）**：\r\n- 文件名格式：`小红书每日爆款笔记_{分类}_唯一时间戳.html`\r\n- 唯一时间戳：`YYYYMMDD_HHmmss`（当前生成时间，精确到秒）\r\n- 示例：`小红书每日爆款笔记_日常生活_20260528_144500.html`\r\n\r\n## 订阅服务说明\r\n\r\n### 订阅内容\r\n\r\n**小红书每日爆款笔记推荐TOP50**\r\n\r\n- 每日19:30更新\r\n- 推送当日的50篇热门内容\r\n- 包含完整分析和HTML文件\r\n\r\n### 订阅触发方式\r\n\r\n用户回复\"1\"或\"订阅\"即可开通每日推送。推送时按标准输出格式（每日爆款笔记 + 每日分析 + 功能服务询问）执行。\r\n\r\n## 使用示例\r\n\r\n### 示例1：关键词查询\r\n\r\n- **场景/输入**：\"帮我查一下睫毛膏相关的爆款笔记\"\r\n- **预期产出**：匹配化妆美容分类，依次输出每日爆款笔记、每日分析、功能服务询问\r\n\r\n### 示例2：泛查询热门内容\r\n\r\n- **场景/输入**：\"最近小红书有什么热门内容\"\r\n- **预期产出**：使用综合全部分类，依次输出每日爆款笔记、每日分析、功能服务询问\r\n\r\n## 资源索引\r\n\r\n- **脚本**：见 [scripts/xhs_daily_fetcher.py](scripts/xhs_daily_fetcher.py)\r\n  - 用途：获取小红书爆款内容榜单数据\r\n  - 参数：--category 分类名 / --keyword 关键词 / --top_n 条数\r\n- **脚本**：见 [scripts/gen_xhs_html.py](scripts/gen_xhs_html.py)\r\n  - 用途：生成可视化HTML页面\r\n  - 参数：--category 分类名 / --top 条数 / --output 输出路径\r\n\r\n## 注意事项\r\n\r\n- 数据每日19:00更新昨天的榜单\r\n- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含每日爆款笔记（更新时间）+ 每日爆款笔记分析 + 功能服务询问\r\n  - 🔥 每日爆款笔记（必须包含更新时间）\r\n  - 📊 每日爆款笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\r\n  - **功能服务询问（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复）**：每日分析后立即原样输出询问文案\r\n  - **禁止输出遗漏，禁止胡乱输出，必须严格按照此3项内容输出**\r\n- **输出格式要求（强制）**：\r\n  - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\r\n  - **禁止输出文件**：禁止输出任何文件（如CSV、JSON、TXT等）\r\n  - **输出顺序**：严格按照每日爆款笔记 → 每日分析 → 功能服务询问的顺序执行，禁止混乱输出\r\n- **输出顺序（严格按此顺序执行，禁止混乱输出）**：\r\n  1. **🔥 每日爆款笔记**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）\r\n  2. **📊 每日爆款笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）\r\n  3. **功能服务询问（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复）**：每日分析后立即原样输出询问文案\r\n- **HTML页面生成规则（按需生成）**：\r\n  - HTML页面不再自动生成，改为用户回复\"2\"或\"生成\"后执行\r\n  - 文件名格式：`小红书每日爆款笔记_{分类}_YYYYMMDD_HHmmss.html`\r\n  - 生成后直接输出HTML页面，禁止只输出文件路径\r\n  - **PDF和图片导出内容一定是正确的**\r\n- **功能服务询问输出要求（强制，禁止遗漏）**：\r\n  - 功能服务询问是输出内容之一，禁止遗漏\r\n  - 必须在每日分析完成后立即展示，不能等待用户回复\r\n  - **禁止跳过，禁止遗漏，禁止等待用户回复，禁止折叠**\r\n  - 用户回复\"1\"或\"订阅\"：开通订阅\r\n  - 用户回复\"2\"或\"生成\"：生成HTML文件包\r\n- **数据一致性要求**：每日爆款笔记表格与HTML页面必须使用相同的数据源，禁止修改接口返回的顺序，确保完全一致\r\n- **数据完整性要求（强制）**：\r\n  - 表格所有字段和数据必须完整加载\r\n  - 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\r\n  - 直到所有字段都有完整数据（每日爆款笔记7个字段、每日分析所有表格字段）\r\n- **数据输出逻辑（必须严格执行）**：\r\n  - 首次输出：每日爆款笔记TOP1-20，HTML页面TOP1-20（保持一致）\r\n  - 查看更多：每日爆款笔记TOP21-实际数据末尾，HTML页面TOP1-实际数据末尾（完整数据）\r\n  - **\"查看更多\"提示逻辑**：\r\n    - 数据 ≤ 20条：不展示\r\n    - 数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"\r\n    - 数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"\r\n- 表格字段：排名、笔记信息、互动数（新增互动）、点赞（新增点赞）、评论（新增评论）、收藏（新增收藏）、分享（新增分享，**必须展示且不能出错，避免胡乱输出**）\r\n- 每日分析包含：热门内容分析、爆款标题分析、最高数据作品分析\r\n- 每日分析标题后显示\"以下内容分析基于获取的全部数据（共{数据条数}条）进行~\"\r\n- 分析内容从创作者视角出发，提供可执行建议\r\n- **禁止自动查询**：未订阅且未收到用户明确查询输入时，禁止自动调用脚本或输出任何热榜信息\n\nFile v1.0.5:README.en.md\n\n# Xiaohongshu Daily Viral Notes / xiaohongshu-dailytop\r\n\r\n---\r\n\r\n## Introduction\r\n\r\nQuery the TOP50 Xiaohongshu notes with the highest same-day engagement growth by keyword or track, with automatic breakdown of titles, content patterns, and trends — helping creators and operators catch the traffic wave and plan the next post.\r\n\r\n**Core Value**\r\n\r\n- Tracks notes with the highest engagement increment today, not cumulative totals — capturing content that is actively exploding right now\r\n- Three-dimension analysis (hot content, viral titles, top-data posts) delivered in one pass, ready to feed directly into topic planning\r\n- Supports daily 19:30 subscription pushes to continuously track track trend changes\r\n\r\n**Who It's For**\r\n\r\n- ✍️ Beauty / fashion and other vertical creators — find daily benchmark notes and extract replicable title structures and content formulas\r\n- 📢 FMCG brand operators — stay on top of today's breakout content to guide placements and seeding direction\r\n- 🔍 MCN talent scouts — spot low-follower high-engagement breakout notes to assess account growth potential\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Single-day breakout rankings**: Fetch today's hot notes TOP50, supporting 25 vertical categories with precise matching\r\n- **Smart pattern analysis**: Generate three-dimension reports — hot content analysis, viral title analysis, top-data post analysis\r\n- **Multi-dimension data display**: Full presentation of total engagement, likes, comments, collects, shares, and new incremental data\r\n- **Auto subscription push**: Subscribe to receive the latest rankings at a fixed time of 19:30 every day\r\n\r\n### Highlights\r\n\r\n- Input \"mascara\" and it auto-matches \"Beauty & Makeup\" — no manual category selection needed\r\n- First output shows TOP20; reply \"load more\" to get the rest, with HTML synced to full data\r\n- Ranking table and HTML page share the same data source and order — fully consistent\r\n\r\n---\r\n\r\n## API Key Acquisition & Security\r\n\r\n- This skill requires the environment variable: `REDFOX_API_KEY`.\r\n- `REDFOX_API_KEY` is provided by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`).\r\n- Visit [RedFoxHub](https://redfox.hk?source=github) to register and obtain your `REDFOX_API_KEY`.\r\n- Configure the `REDFOX_API_KEY` environment variable on your device before using this skill.\r\n- Before using a key, confirm its source, scope, expiry, and whether it supports reset or revocation.\r\n- Never hard-code or expose the key in plaintext within code, prompts, logs, or output files.\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\nDescribe 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| Query today's virals      | `Show me viral notes about mascara`            | Auto-matches category, outputs today's breakout TOP20 + three-dimension analysis + HTML + subscription option |\r\n| Query general hot content | `What's trending on Xiaohongshu lately?`       | Uses \"All\" category, full four-section output                                                                 |\r\n| Query specific date       | `Show beauty daily viral notes for 2026-04-20` | Queries single-day breakout rankings for the specified date and category                                      |\r\n| Load more                 | Reply \"load more\"                              | Shows TOP21 to end; HTML refreshes to full data                                                               |\r\n| Subscribe to push         | Reply `1` after output completes               | Activates daily 19:30 push of Xiaohongshu daily viral notes TOP50                                             |\r\n\r\n### Output Example\r\n\r\nEach query produces four fixed sections: daily viral notes rankings → three-dimension pattern analysis → HTML visual page → subscription service options.\r\n\r\n---\r\n\r\n## Use Cases\r\n\r\n| Scenario                     | Role                       | Example question                                                    | Benefit                                                                       |\r\n| ---------------------------- | -------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------- |\r\n| Daily viral inspiration      | Beauty / fashion creator   | `Show today's beauty viral notes`                                   | Extract today's viral title structures and content patterns for the next post |\r\n| Real-time hot topic tracking | Brand Xiaohongshu operator | `Subscribe to daily fashion breakout push`                          | Continuously track track changes, respond to hot topics faster                |\r\n| Rising note discovery        | MCN talent scout           | `What low-follower high-engagement food breakouts are there today?` | Use new engagement data increments to discover growth-stage accounts          |\r\n| Daily data review            | Growth / data analyst      | `Fetch today's full tech TOP50 and export HTML`                     | Export PDF for daily reports with a unified, archivable data source           |\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\n小红书每日爆款笔记 helps creators and operators query Xiaohongshu daily TOP50 breakout notes by keyword or category and turn ranking data into reusable topic, title, and content-pattern insights.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[if530770](https://clawhub.ai/user/if530770)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal creators, brand operators, MCN scouts, and growth analysts use this skill to monitor daily Xiaohongshu breakout content, identify fast-rising topics, and generate ranking tables, trend analysis, and optional HTML reports for planning or review.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends a RedFox API key and query metadata to redfox.hk.\n\nMitigation: Use a scoped or session-limited key where possible, store it in an environment variable or secret manager, and rotate or revoke it if exposed.\n\nRisk: Environment-variable setup instructions can lead an agent to write or echo a plaintext API key in shell profiles or terminal output.\n\nMitigation: Prefer a secret manager or session-scoped environment variable, and avoid placing the key in logs, prompts, committed files, or shared shell history.\n\nRisk: Generated HTML reports and JSON cache inputs can contain untrusted content and reports may load JavaScript from a CDN.\n\nMitigation: Open generated reports only in a trusted environment, review cache inputs before reuse, and apply normal browser and file-handling precautions.\n\nRisk: Daily subscription pushes can continue sending trend data after setup.\n\nMitigation: Enable subscription only with clear user intent and keep a known cancellation path available.\n\n## Reference(s):\n\n- [Core workflow](artifact/references/core_workflow.md)\n- [English README](artifact/README.en.md)\n- [ClawHub skill page](https://clawhub.ai/if530770/skills/xhs-daily-ranking)\n- [RedFoxHub](https://redfox.hk/)\n- [RedFoxHub API keys](https://redfox.hk/settings/api-keys?source=clawhub)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, analysis, shell commands, configuration, guidance, files]\n\n**Output Format:** [Markdown tables and prose, with optional standalone HTML report files and inline shell commands.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires REDFOX_API_KEY; optional HTML reports may load CDN JavaScript and can be generated from JSON cache input.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release metadata)\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.4: 7 files, 42241 bytes\n\nFiles: references/core_workflow.md (25138b), scripts/gen_xhs_html.py (30466b), scripts/xhs_daily_fetcher.py (26331b), scripts/xhs_weekly.html (37151b), skill-card.md (2252b), SKILL.md (9746b), _meta.json (136b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: xhs-daily-ranking\ndescription: 小红书每日风向标是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。\n---\n\n# 小红书每日风向标\n\n---\n\n## 简介\n\n小红书每日风向标是一款专为内容创作者和营销人员设计的智能工具，帮助用户实时追踪小红书平台当日的爆款笔记数据。\n\n通过简单的关键词查询，你可以：\n\n- 🔥 获取每日单日爆发榜TOP50，解决「不知道今天什么内容在爆」的痛点\n- 📊 自动分析爆款特征和规律，解决「找爆文、拆规律效率低」的痛点\n- 📁 生成可视化HTML页面，一键导出分享，大幅降低内容分析成本\n- 🔔 支持每日固定时间订阅推送，不用手动重复查询\n\n适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。\n\n**技术基础**：基于小红书公开内容接口，每日19:00更新昨日榜单数据。\n\n---\n\n## 功能特性\n\n### 🎯 核心功能\n\n- **🔥 单日爆发榜查询**：获取当日热门笔记TOP50，按分类查询，支持25个垂直领域精准匹配\n- **📊 智能规律分析**：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告\n- **📈 多维度数据展示**：完整呈现互动数、点赞、评论、收藏、分享及新增数据\n- **🔔 自动订阅推送**：支持每日19:30固定时间推送最新榜单到消息栏\n\n### ✨ 特色亮点\n\n- **⏰ 智能日期适配**：支持指定日期或模糊日期查询，自动按规则匹配近2天数据\n- **📤 多格式输出**：自动生成Markdown表格+HTML可视化文件，支持导出PDF/图片\n- **🔗 一键跳转**：笔记和作者主页可直接点击跳转，查看原内容更便捷\n- **⚡ 无额外门槛**：无需小红书账号、无需API密钥，安装依赖即可使用\n\n## 使用指南\n\n### 基础使用（3步）\n\n#### 1. 发起查询\n\n告诉工具你要查询的分类或关键词（未指定日期则自动按规则匹配近2天数据）：\n\n> 用户：帮我查一下睫毛膏相关的爆款笔记\n>\n> 助手：正在为你查询化妆美容分类的单日爆发榜数据...\n\n#### 2. 查看完整输出\n\n系统自动输出4项内容（完整流程规范见 [references/core_workflow.md](references/core_workflow.md)）：\n\n| 序号 | 输出内容            | 说明                                         |\n| ---- | ------------------- | -------------------------------------------- |\n| 1    | 🔥 单日爆发榜       | 含更新时间，展示TOP20数据                    |\n| 2    | 📊 单日爆发笔记分析 | 热门内容分析、爆款标题分析、最高数据作品分析 |\n| 3    | 📁 HTML页面         | 直接输出可视化页面，支持导出PDF/图片         |\n| 4    | 🔔 订阅服务         | 每日19:30推送选项                            |\n\n#### 3. 查看更多数据\n\n默认输出TOP20内容，输入「查看更多」即可获取全部50条内容：\n\n> 用户：查看更多\n>\n> 助手：为你展示全部50条单日爆发笔记...\n\n---\n\n### 高级使用（4步）\n\n#### 1. 分类匹配规则（内部执行）\n\n系统会根据用户输入自动匹配合适的分类，分类匹配逻辑在执行时内部完成，不直接向用户展示具体映射规则或匹配细节。\n\n如需查看完整匹配规范，请参考 `references/core_workflow.md`。\n\n#### 2. 日期判断规则\n\n- 用户指定了日期 → 直接使用指定日期\n- 用户未指定日期：\n  - 当前时间 >= 19:00 → 查询**昨日**数据\n  - 当前时间 < 19:00 → 查询**前天**数据\n\n#### 3. 数据输出逻辑\n\n| 阶段     | 单日爆发榜 | HTML页面          | 提示                          |\n| -------- | ---------- | ----------------- | ----------------------------- |\n| 首次输出 | TOP1-20    | TOP1-20           | 数据>20条时显示\"查看更多\"提示 |\n| 查看更多 | TOP21-末尾 | TOP1-末尾（完整） | -                             |\n\n#### 4. 数据一致性保障\n\n- 单日爆发榜表格与HTML页面必须使用相同数据源\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\n\n---\n\n### 命令速查表\n\n| 命令                   | 功能                        | 示例                     |\n| ---------------------- | --------------------------- | ------------------------ |\n| `查[关键词]爆款`       | 查询指定分类的单日爆发榜    | 查睫毛膏爆款             |\n| `查[日期][关键词]爆款` | 查询指定日期/分类的爆文榜单 | 查2026-04-20化妆美容爆款 |\n| `查看更多`             | 获取完整50条榜单数据        | 查看更多                 |\n| `订阅`                 | 开通每日爆款推送            | 订阅                     |\n| `取消订阅`             | 关闭每日推送服务            | 取消订阅                 |\n\n---\n\n## 使用场景\n\n| 场景            | 角色               | 需求                                           | 使用方式                                                           |\n| --------------- | ------------------ | ---------------------------------------------- | ------------------------------------------------------------------ |\n| 找对标内容      | 0粉新手美妆博主    | 不知道小账号做什么内容能爆，头部博主参考性太低 | 每天查询美妆类单日爆发榜，拆解标题/内容/封面，模仿同款内容做差异化 |\n| 品牌运营跟热点  | 快消品牌小红书运营 | 跟进平台最新热点，做符合用户喜好的营销内容     | 订阅每日推送，提取热门关键词和内容形式融入品牌推广                 |\n| MCN挖掘潜力新人 | MCN内容星探        | 挖掘还没火的潜力博主，降低签约成本             | 每天查看全分类单日爆发榜，筛选高互动新账号重点关注                 |\n| 内容策划找灵感  | 内容策划/文案编辑  | 快速了解平台近期热门内容方向，为选题提供参考   | 按分类查询当日爆发榜，分析爆款共性特征总结模版                     |\n\n---\n\n## 项目架构\n\n### 目录结构\n\n```\nxhs-daily-ranking/\n├── scripts/\n│   ├── xhs_daily_fetcher.py   # 数据拉取、榜单生成核心脚本\n│   └── gen_xhs_html.py        # HTML可视化文件生成脚本\n├── references/\n│   └── core_workflow.md       # 完整功能流程规范（核心）\n├── requirements.txt           # 依赖声明\n└── SKILL.md                  # Skill定义文档\n```\n\n### 技术栈\n\n- **运行环境**：Python 3.8+\n- **依赖库**：requests>=2.28.0\n- **输出格式**：Markdown / HTML\n- **数据来源**：小红书公开内容接口\n\n### 数据流转\n\n```\n用户请求 → 参数校验（日期/分类匹配） → 调用公开接口拉取数据\n    ↓\n生成Markdown榜单 → 规律分析 → 渲染HTML文件\n    ↓\n返回4项结果（榜单 + 分析 + HTML + 订阅选项）→ 用户响应\n```\n\n---\n\n## ⚠️ 输出规范（重要）\n\n> 完整功能流程规范见 [references/core_workflow.md](references/core_workflow.md)\n\n### 触发前提（强制，禁止违反）\n\n- **禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息**\n- 只有当用户主动输入关键词、分类名或明确表达查询意图时，才可调用脚本获取数据\n- **禁止主动向用户推送热榜数据、禁止在闲聊或无关对话中自动调用接口**\n\n### 四项输出内容（强制执行）\n\n| 序号 | 输出内容            | 要求                           |\n| ---- | ------------------- | ------------------------------ |\n| 1    | 🔥 单日爆发榜       | 含更新时间，禁止折叠，禁止遗漏 |\n| 2    | 📊 单日爆发笔记分析 | 3个模块，禁止折叠，禁止遗漏    |\n| 3    | 📁 HTML页面         | 直接输出页面，禁止只输出路径   |\n| 4    | 🔔 订阅服务         | HTML页面后立即输出，禁止跳过   |\n\n### 输出格式要求（强制执行）\n\n- **禁止折叠输出**：所有内容必须直接完整输出\n- **禁止输出文件**：除HTML页面外，禁止输出任何其他文件\n- **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务\n\n### 执行脚本命令\n\n```bash\n# 获取榜单数据（最多50条）\npython scripts/xhs_daily_fetcher.py --keyword \"{关键词}\" --top_n 50\n\n# 生成HTML页面\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20   # 首次输出\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50   # 查看更多\n```\n\n---\n\n## 资源索引\n\n| 资源         | 路径                           | 说明                             |\n| ------------ | ------------------------------ | -------------------------------- |\n| 完整流程规范 | `references/core_workflow.md`  | 详细输出规范、操作步骤、使用示例 |\n| 数据获取脚本 | `scripts/xhs_daily_fetcher.py` | 获取小红书爆款内容榜单数据       |\n| HTML生成脚本 | `scripts/gen_xhs_html.py`      | 生成可视化HTML页面               |\n\n---\n\n### 订阅服务内容（必须原样输出，禁止修改，禁止省略）\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"xhs-daily-ranking\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1778817062806\n}\n\nFile v1.0.4:references/core_workflow.md\n\n# 小红书每日风向标\n\n## 任务目标\n\n- 本 Skill 用于：获取小红书平台爆款内容榜单数据\n- 能力包含：\n  - 单日爆发榜数据获取（按分类查询）\n  - 单日热门笔记智能分析\n  - 冷门爆款笔记挖掘（关键词匹配分类）\n  - 订阅服务（每日定时推送）\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\n\n## 数据接口更新规则\n\n- **更新时间**：每天19:00更新昨天的榜单数据\n- **数据范围**：当日的热门笔记TOP50\n- **分类覆盖**：25个垂直领域分类\n\n## 输出规范（强制执行）\n\n**触发前提（强制，禁止违反）**：\n\n- **禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息**\n- 只有当用户主动输入关键词、分类名或明确表达查询意图时，才可调用脚本获取数据\n- 仅订阅推送场景下，按订阅约定时间自动输出，其余场景一律等待用户主动触发\n- **禁止主动向用户推送热榜数据、禁止在闲聊或无关对话中自动调用接口**\n\n**数据一致性要求（重要）**：\n\n- 单日爆发榜表格与HTML页面数据必须完全一致（相同顺序、相同内容）\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\n- 禁止胡乱渲染或使用不同数据源\n\n**输出内容必须严格包含以下四部分，禁止遗漏或胡乱输出：**\n\n- **单日爆发榜（更新时间）**：必须直接输出，禁止折叠，禁止遗漏\n- **单日爆发笔记分析**：必须直接输出，禁止折叠，禁止遗漏\n- **HTML页面**：必须生成并输出，禁止折叠，禁止遗漏\n- **订阅服务**：必须在HTML页面之后强制输出，禁止跳过，禁止遗漏，禁止等待用户回复\n\n**输出格式要求（强制执行）**：\n\n- **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n- **禁止输出文件**：除HTML页面外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n- **HTML必须直接输出页面，禁止只输出文件路径**\n- **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务的顺序执行，禁止混乱输出\n\n### 第一部分：单日爆发榜（必须包含榜单的数据更新时间）\n\n**输出要求**：\n\n- 必须直接完整输出表格内容\n- 禁止折叠、隐藏或展开表格\n- 禁止输出为文件格式\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\n\n- 标题格式：**🔥 【{分类名称}】单日爆发榜 （更新时间：{查询日期} 19:00）**（标题整体加粗）\n- 标题示例：**🔥 【化妆美容】单日爆发榜 （更新时间：2026-04-21 19:00）**\n\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\n\n| 排名 | 笔记信息                                         |      互动数       |       点赞        |       评论       |       收藏       |       分享        |\n| :--: | :----------------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\n|  🥇  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 22w+<br>↑新增23w+ | 22w+<br>↑新增21w+ | 893<br>↑新增21w+ | 1w+<br>↑新增21w+ | 1w+<br>↑新增21w+  |\n|  🥈  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 20w+<br>↑新增18w+ | 18w+<br>↑新增16w+ | 756<br>↑新增18w+ | 8k+<br>↑新增16w+ | 900+<br>↑新增16w+ |\n|  🥉  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 18w+<br>↑新增15w+ | 15w+<br>↑新增13w+ | 621<br>↑新增15w+ | 7k+<br>↑新增13w+ | 800+<br>↑新增13w+ |\n\n**字段详细说明**：\n\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\n- **笔记信息**：\n  - 第一行：笔记标题（可点击跳转）\n  - 第二行：[作者名](作者主页链接) 粉丝数+（作者名可点击跳转到作者主页，链接使用API返回的userJumpUrl字段，字号与标题一样大）\n- **互动数**：\n  - 第一行：累计互动数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **点赞**：\n  - 第一行：累计点赞数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **评论**：\n  - 第一行：累计评论数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **收藏**：\n  - 第一行：累计收藏数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **分享**：\n  - 第一行：累计分享数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n  - **分享字段必须展示且不能出错**\n\n**重要说明**：\n\n- 使用标准 Markdown 表格格式\n- 单元格内使用 `<br>` 换行显示累计数据和新增数据\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\n- 新增数据格式：累计数据 <br> ↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\n- \"↑新增\"文案字号比累计数据小一号\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\n\n**数据说明（必须在表格上方、标题之后输出）**：\n\n- 在单日爆发榜标题之后、表格之前输出：_单日爆发榜指笔记发后第3天比第2天涨的数据由高到低Top50_\n\n**数据输出逻辑（必须严格执行）**：\n\n- **首次输出**：\n  - 单日爆发榜表格：显示TOP1到TOP20\n  - HTML页面：显示TOP1到TOP20（与热榜表格保持一致）\n  - **\"查看更多\"提示逻辑**（必须严格执行）：\n    - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\n    - 如果返回数据 > 20条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"（显示剩余数据条数）\n    - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\n- **用户输入\"查看更多\"后**：\n  - 单日爆发榜表格：输出TOP21到实际数据末尾（延续之前的TOP20）\n  - HTML页面：输出TOP1到实际数据末尾（完整数据，覆盖之前的HTML文件）\n\n### 第二部分：单日爆发笔记分析\n\n**输出要求**：\n\n- 必须直接完整输出3个模块内容（热门内容分析、爆款标题分析、最高数据作品分析）\n- 禁止折叠、隐藏或展开任何模块\n- 禁止输出为文件格式\n- 所有分析内容都基于获取到的所有数据\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\n- **必须包含3个模块，禁止遗漏**\n\n- 标题格式：**📊 单日爆发笔记分析**（加粗，不带Top数量）\n- 示例：**📊 单日爆发笔记分析**\n\n以下内容分析基于获取的全部数据（共{数据条数}条）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征                                                                                                                                                                           | 实际效果      | 参考笔记                           |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]<br>[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望                           | 互动率提升50% | [笔记标题链接3]<br>[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查                         | 收藏率提升55% | [笔记标题链接5]<br>[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力                                     | 曝光率提升40% | [笔记标题链接7]<br>[笔记标题链接8] |\n\n**📈爆款标题分析**\n\n| 标题类型 | 标题特征                                                                                                           | 标题模版         | 发布规律             | 参考标题                 |\n| :------- | :----------------------------------------------------------------------------------------------------------------- | :--------------- | :------------------- | :----------------------- |\n| 提问式   | 标题以疑问句开头，设置悬念或提出用户关心的问题，引发用户的好奇心和思考欲望，激发点击阅读或评论互动                 | \"你还在XX吗？\"   | 工作日早高峰效果最佳 | 这个方法你还在用吗？     |\n| 数字式   | 标题中包含具体的数字、数量或统计数据，利用人们对量化信息的偏好，增强内容的可信度和专业感，让用户觉得内容有价值     | \"XX个XX技巧\"     | 午餐时间点击率高     | 5个快速提升XX的技巧      |\n| 情绪词   | 使用具有强烈情感色彩的词汇或网络流行语，如\"绝了\"、\"太XX了\"等，直接触发用户的情绪反应，引发点赞、评论或分享行为     | \"太XX了！忍不住\" | 晚间黄金时段转化高   | 太好用了！忍不住分享给你 |\n| 利益点   | 直接在标题中明确承诺用户可以获得的具体利益或效果，如\"XX天就能XX\"、\"省XX元\"等，降低用户决策成本，提高点击率和收藏率 | \"XX天就能XX\"     | 深夜发布收藏率最高   | 7天就能看到明显效果      |\n\n**✨最高数据作品分析**\n\n| 维度     | 核心特征分析                                               | 参考笔记       |\n| :------- | :--------------------------------------------------------- | :------------- |\n| 最高点赞 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n\n### 第三部分：HTML页面\n\n**强制要求（必须严格遵守）**：\n\n- HTML页面是4项输出中的第3项，必须在单日爆发榜和单日分析之后输出\n- 不需要等待用户回复，单日分析输出后立即执行\n- **禁止只输出文件路径，必须直接输出HTML页面**\n- **禁止折叠输出**\n- 这是唯一允许输出的文件，其他内容禁止输出为文件\n\n**执行命令**：\n\n- **首次输出**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\n- **用户输入\"查看更多\"后**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50`\n\n**文件特点**：\n\n- 可独立打开的HTML文件\n- 支持直接点击链接跳转\n- 支持导出图片和PDF功能（导出结果与页面显示完全一致，PDF和图片导出内容一定是正确的）\n- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为\"↑新增数值\"格式，整体字号增大1px\n- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据，分享字段必须展示且不能出错）\n\n## 数据输出逻辑详解\n\n**核心原则**：\n\n- 单日爆发榜表格与HTML页面必须保持数据一致性\n- 使用相同的API接口，禁止修改接口返回的顺序\n\n### 阶段一：首次输出\n\n1. **单日爆发榜表格**：\n   - 调用脚本获取数据（最多50条）\n   - 展示TOP1到TOP20（前20条）\n   - **\"查看更多\"提示逻辑（根据实际数据量动态调整）**：\n     - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\n     - 如果返回数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{实际剩余数量}条！✨\"\n     - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\n\n2. **HTML页面**：\n   - 执行命令：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\n   - 生成HTML文件，包含TOP1到TOP20数据\n   - 与单日爆发榜表格数据完全一致\n\n### 阶段二：用户输入\"查看更多\"\n\n1. **单日爆发榜表格**：\n   - 继续展示TOP21到实际数据末尾（根据实际数据量）\n   - 延续首次输出的数据，不重复TOP1-20\n\n### 第四部分：订阅服务（紧接HTML页面之后输出，禁止跳过）\n\n**强制要求（必须严格遵守）**：\n\n- 必须在HTML页面输出完成后展示\n- 提供每日19:30推送小红书单日热门笔记TOP50的订阅选项\n- 用户可回复数字或\"取消\"\n- **禁止遗漏，禁止胡乱输出**\n\n**订阅服务内容（必须原样输出，禁止修改，禁止省略）**：\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\n**订阅逻辑**：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n\n**输出顺序（严格按此顺序执行，禁止混乱输出，禁止遗漏）**：\n\n1. 🔥 单日爆发榜（含更新时间）\n2. 📊 单日爆发笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n3. 📁 HTML页面（直接输出，禁止只输出路径）\n4. 订阅服务（推送选项）\n\n**重要提示（强制，禁止违反）**：\n\n- **必须严格包含以上4项内容，禁止遗漏**\n  - 🔥 单日爆发榜（含更新时间）\n  - 📊 单日爆发笔记分析（3个模块）\n  - 📁 HTML页面（直接输出页面，输出后继续执行订阅服务）\n  - **订阅服务（推送选项，必须在HTML页面之后立即输出，禁止跳过，禁止遗漏）**\n- **禁止胡乱输出，禁止输出其他内容**\n- **禁止输出顺序混乱，必须严格按照上述顺序**\n- **订阅服务必须强制执行，HTML页面输出完成后必须立即展示订阅服务，不能等待用户回复，不能跳过，不能遗漏**\n\n### 数据一致性保障\n\n- 两个脚本使用相同的API接口\n- 相同的API接口，禁止修改接口返回的顺序\n- 相同的数据字段和格式\n- 确保表格和HTML页面的排名、数据完全一致（禁止修改接口返回的顺序）\n\n## 操作步骤\n\n### 标准流程\n\n#### 第一步：分类匹配\n\n根据用户输入自动匹配合适的分类：\n\n**可用分类列表（共25个）**：\n综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n\n**匹配规则**：\n\n- 用户输入具体产品词（如\"睫毛膏\"）→ 匹配对应分类（\"化妆美容\"）\n- 用户输入领域词（如\"穿搭\"、\"美食\"）→ 直接匹配分类\n- 未指定分类 → 使用\"综合全部\"\n\n**关键词-分类映射示例**：\n\n```\n睫毛膏/口红/粉底 → 化妆美容\n穿搭/衣服/时尚 → 时尚穿搭\n美食/做饭/探店 → 美味佳肴\n猫/狗/宠物 → 宠物天地\n游戏/王者/电竞 → 休闲娱乐\n```\n\n#### 第二步：查询冷门爆款笔记\n\n- 用户输入关键词后，自动匹配对应分类（**不告知用户匹配到的分类名称**）\n- 查询该分类下的冷门爆款笔记（最多50条）\n- **根据实际数据量动态展示**：\n  - 如果返回数据 ≤ 20条：默认展示全部数据，不展示\"查看更多\"提示\n  - 如果返回数据 > 20条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余{数量}条！✨\"提示\n  - 如果返回数据 = 50条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余30条！✨\"提示\n\n#### 第三步：日期判断\n\n根据用户输入和当前时间确定查询日期：\n\n**判断规则**：\n\n1. **用户指定了日期** → 直接使用指定日期\n2. **用户未指定日期**：\n   - 当前时间 >= 19:00 → 查询**昨日**数据（当日19:00已更新）\n   - 当前时间 < 19:00 → 查询**前天**数据（等待当日19:00更新）\n\n#### 第四步：获取单日爆发榜数据\n\n调用脚本获取榜单数据：\n\n```bash\npython scripts/xhs_daily_fetcher.py --keyword \"睫毛膏\" --top_n 50\n```\n\n**参数说明**：\n\n- `--category`：分类名称（可选）\n- `--keyword`：用户输入的关键词，用于自动匹配分类\n- `--rank_date`：查询日期（可选，自动判断）\n- `--top_n`：返回条数（默认50）\n\n**数据完整性要求**：\n\n- 确保表格所有字段和数据完整加载\n- 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\n- 直到所有字段（排名、笔记信息、互动数、点赞、评论、收藏、分享）都有完整数据\n- **分享字段使用正确的API字段名**：`AnaAddBean.useShareCount`（累计分享数）、`AnaAddBean.addShareCount`（新增分享数）\n- **确保分享数值正确输出，避免使用错误的字段名导致数值不对**\n\n#### 第五步：输出单日爆发榜和单日分析\n\n按照输出规范，依次输出：\n\n1. 单日爆发榜（含更新时间）\n2. 单日爆发笔记分析（3个模块）\n\n#### 第六步：生成HTML页面（4项输出中的第3项）\n\n**重要要求：HTML页面输出完成后必须继续执行第七步（订阅服务），HTML不是最后一步**\n\n生成可视化HTML页面：\n\n**首次输出时**：\n\n```bash\npython scripts/gen_xhs_html.py --keyword \"穿搭\" --top 20\n```\n\n**用户输入\"查看更多\"后**：\n\n```bash\npython scripts/gen_xhs_html.py --keyword \"穿搭\" --top 50\n```\n\n**输出格式（直接输出HTML页面，禁止只输出文件路径）**：\n\n#### 第七步：输出订阅服务（强制，禁止跳过，禁止遗漏）\n\n**必须在HTML页面输出完成后立即执行此步，不能等待用户回复，不能跳过，不能遗漏**\n\n直接输出以下内容（禁止修改，禁止省略）：\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\n**订阅逻辑**：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n\n## 订阅服务说明\n\n### 订阅内容\n\n**小红书单日爆发笔记推荐TOP50**\n\n- 每日19:30更新\n- 推送当日的50篇热门内容\n- 包含完整分析和HTML文件\n\n### 订阅输出格式\n\n按上述4项输出顺序执行即可，与标准输出格式一致。\n\n## 使用示例\n\n### 示例1：关键词查询\n\n- **场景/输入**：\"帮我查一下睫毛膏相关的爆款笔记\"\n- **预期产出**：匹配化妆美容分类，依次输出单日爆发榜、单日分析、HTML页面、订阅服务\n\n### 示例2：泛查询热门内容\n\n- **场景/输入**：\"最近小红书有什么热门内容\"\n- **预期产出**：使用综合全部分类，依次输出4项内容\n\n## 资源索引\n\n- **脚本**：见 [scripts/xhs_daily_fetcher.py](scripts/xhs_daily_fetcher.py)\n  - 用途：获取小红书爆款内容榜单数据\n  - 参数：--category 分类名 / --keyword 关键词 / --top_n 条数\n- **脚本**：见 [scripts/gen_xhs_html.py](scripts/gen_xhs_html.py)\n  - 用途：生成可视化HTML页面\n  - 参数：--category 分类名 / --top 条数 / --output 输出路径\n\n## 注意事项\n\n- 数据每日19:00更新昨天的榜单\n- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含单日爆发榜（更新时间）+ 单日爆发笔记分析 + HTML页面 + 订阅服务\n  - 🔥 单日爆发榜（必须包含更新时间）\n  - 📊 单日爆发笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n  - 📁 HTML页面（直接输出HTML页面，禁止只输出文件路径）\n  - **订阅服务（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复）**：🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n  - **禁止输出遗漏，禁止胡乱输出，必须严格按照此4项内容输出，订阅服务与其他3项同等强制**\n- **输出格式要求（强制）**：\n  - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n  - **禁止输出文件**：除HTML页面外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n  - **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务的顺序执行，禁止混乱输出\n- **输出顺序（严格按此顺序执行，禁止混乱输出）**：\n  1. **🔥 单日爆发榜**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）\n  2. **📊 单日爆发笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）\n  3. **📁 HTML页面**（4项输出中的第3项，直接输出HTML页面禁止只输出路径，输出后继续执行订阅服务）\n  4. **订阅服务（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复，与前三项同等强制）**：HTML页面输出完成后立即原样输出订阅服务文案\n- **HTML页面输出要求（强制）**：\n  - 是4项输出中的第3项，直接输出HTML页面，禁止只输出文件路径\n  - **禁止只输出文件路径，必须直接输出HTML页面**\n  - **禁止折叠输出**\n  - **PDF和图片导出内容一定是正确的**\n  - 不需要等待任何流程\n- **订阅服务输出要求（强制，禁止遗漏）**：\n  - 订阅服务是4项输出内容之一，与其他3项同等强制，禁止遗漏\n  - 必须在HTML页面输出完成后立即展示，不能等待用户回复\n  - **禁止跳过，禁止遗漏，禁止等待用户回复，禁止折叠**\n  - 提供订阅选项：每日19:30推送小红书单日爆发笔记TOP50 或 暂不需要-仅本次查询\n  - 订阅逻辑：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n  - 请用户回复数字或\"取消\"\n- **数据一致性要求**：单日爆发榜表格与HTML页面必须使用相同的数据源，禁止修改接口返回的顺序，确保完全一致\n- **数据完整性要求（强制）**：\n  - 表格所有字段和数据必须完整加载\n  - 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\n  - 直到所有字段都有完整数据（单日爆发榜7个字段、单日分析所有表格字段）\n- **数据输出逻辑（必须严格执行）**：\n  - 首次输出：单日爆发榜TOP1-20，HTML页面TOP1-20（保持一致）\n  - 查看更多：单日爆发榜TOP21-实际数据末尾，HTML页面TOP1-实际数据末尾（完整数据）\n  - **\"查看更多\"提示逻辑**：\n    - 数据 ≤ 20条：不展示\n    - 数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"\n    - 数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"\n- 表格字段：排名、笔记信息、互动数（新增互动）、点赞（新增点赞）、评论（新增评论）、收藏（新增收藏）、分享（新增分享，**必须展示且不能出错，避免胡乱输出**）\n- 单日分析包含：热门内容分析、爆款标题分析、最高数据作品分析\n- 单日分析标题后显示\"以下内容分析基于获取的全部数据（共{数据条数}条）进行~\"\n- 分析内容从创作者视角出发，提供可执行建议\n- **禁止自动查询**：未订阅且未收到用户明确查询输入时，禁止自动调用脚本或输出任何热榜信息\n\nFile v1.0.4:skill-card.md\n\n## Description: <br>\n小红书每日风向标追踪小红书各领域每日趋势，监测实时热度变化，识别正在起量的内容方向，并基于当日爆款内容提炼可复用的选题、话术与呈现形式。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[if530770](https://clawhub.ai/user/if530770) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nContent creators, brand marketers, MCN teams, and content planners use this skill to query Xiaohongshu daily trending notes by category or keyword, review ranked engagement data, and generate reusable content inspiration from observed trends. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Ranking queries are sent to a third-party endpoint, and returned rankings, links, and generated HTML may be untrusted while HTTPS verification is disabled. <br>\nMitigation: Review before installing, use only queries suitable for external services, inspect returned links and HTML before relying on them, and require HTTPS certificate verification before production use. <br>\nRisk: The subscription flow can produce recurring daily recommendation messages. <br>\nMitigation: Enable subscription only when recurring messages are desired and keep cancellation handling available to the user. <br>\n\n\n## Reference(s): <br>\n- [Core workflow](references/core_workflow.md) <br>\n- [ClawHub skill page](https://clawhub.ai/if530770/xhs-daily-ranking) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, HTML, Shell commands, Guidance] <br>\n**Output Format:** [Markdown tables and analysis text with a generated HTML visualization] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Can include ranked note links, engagement metrics, trend analysis, exportable HTML, and a daily subscription prompt.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (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.3: 7 files, 41135 bytes\n\nFiles: _skillhub_meta.json (87b), references/core_workflow.md (25138b), scripts/gen_xhs_html.py (30465b), scripts/xhs_daily_fetcher.py (26330b), scripts/xhs_weekly.html (37151b), SKILL.md (9857b), _meta.json (136b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: xhs-daily-ranking\ndescription: 分类查询当日热门笔记：按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。进行单日爆款笔记分析，查看单日互动增长最快、曝光飙升的笔记详情，分析其标题、封面、内容结构等爆款特征。追踪各领域当日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。\n---\n\n# 小红书每日风向标\n\n---\n\n## 简介\n\n小红书每日风向标是一款专为内容创作者和营销人员设计的智能工具，帮助用户实时追踪小红书平台当日的爆款笔记数据。\n\n通过简单的关键词查询，你可以：\n\n- 🔥 获取每日单日爆发榜TOP50，解决「不知道今天什么内容在爆」的痛点\n- 📊 自动分析爆款特征和规律，解决「找爆文、拆规律效率低」的痛点\n- 📁 生成可视化HTML页面，一键导出分享，大幅降低内容分析成本\n- 🔔 支持每日固定时间订阅推送，不用手动重复查询\n\n适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。\n\n**技术基础**：基于小红书公开内容接口，每日19:00更新昨日榜单数据。\n\n---\n\n## 功能特性\n\n### 🎯 核心功能\n\n- **🔥 单日爆发榜查询**：获取当日热门笔记TOP50，按分类查询，支持25个垂直领域精准匹配\n- **📊 智能规律分析**：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告\n- **📈 多维度数据展示**：完整呈现互动数、点赞、评论、收藏、分享及新增数据\n- **🔔 自动订阅推送**：支持每日19:30固定时间推送最新榜单到消息栏\n\n### ✨ 特色亮点\n\n- **⏰ 智能日期适配**：支持指定日期或模糊日期查询，自动按规则匹配近2天数据\n- **📤 多格式输出**：自动生成Markdown表格+HTML可视化文件，支持导出PDF/图片\n- **🔗 一键跳转**：笔记和作者主页可直接点击跳转，查看原内容更便捷\n- **⚡ 无额外门槛**：无需小红书账号、无需API密钥，安装依赖即可使用\n\n## 使用指南\n\n### 基础使用（3步）\n\n#### 1. 发起查询\n\n告诉工具你要查询的分类或关键词（未指定日期则自动按规则匹配近2天数据）：\n\n> 用户：帮我查一下睫毛膏相关的爆款笔记\n>\n> 助手：正在为你查询化妆美容分类的单日爆发榜数据...\n\n#### 2. 查看完整输出\n\n系统自动输出4项内容（完整流程规范见 [references/core_workflow.md](references/core_workflow.md)）：\n\n| 序号 | 输出内容            | 说明                                         |\n| ---- | ------------------- | -------------------------------------------- |\n| 1    | 🔥 单日爆发榜       | 含更新时间，展示TOP20数据                    |\n| 2    | 📊 单日爆发笔记分析 | 热门内容分析、爆款标题分析、最高数据作品分析 |\n| 3    | 📁 HTML页面         | 直接输出可视化页面，支持导出PDF/图片         |\n| 4    | 🔔 订阅服务         | 每日19:30推送选项                            |\n\n#### 3. 查看更多数据\n\n默认输出TOP20内容，输入「查看更多」即可获取全部50条内容：\n\n> 用户：查看更多\n>\n> 助手：为你展示全部50条单日爆发笔记...\n\n---\n\n### 高级使用（4步）\n\n#### 1. 分类匹配规则（内部执行）\n\n系统会根据用户输入自动匹配合适的分类，分类匹配逻辑在执行时内部完成，不直接向用户展示具体映射规则或匹配细节。\n\n如需查看完整匹配规范，请参考 `references/core_workflow.md`。\n\n#### 2. 日期判断规则\n\n- 用户指定了日期 → 直接使用指定日期\n- 用户未指定日期：\n  - 当前时间 >= 19:00 → 查询**昨日**数据\n  - 当前时间 < 19:00 → 查询**前天**数据\n\n#### 3. 数据输出逻辑\n\n| 阶段     | 单日爆发榜 | HTML页面          | 提示                          |\n| -------- | ---------- | ----------------- | ----------------------------- |\n| 首次输出 | TOP1-20    | TOP1-20           | 数据>20条时显示\"查看更多\"提示 |\n| 查看更多 | TOP21-末尾 | TOP1-末尾（完整） | -                             |\n\n#### 4. 数据一致性保障\n\n- 单日爆发榜表格与HTML页面必须使用相同数据源\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\n\n---\n\n### 命令速查表\n\n| 命令                   | 功能                        | 示例                     |\n| ---------------------- | --------------------------- | ------------------------ |\n| `查[关键词]爆款`       | 查询指定分类的单日爆发榜    | 查睫毛膏爆款             |\n| `查[日期][关键词]爆款` | 查询指定日期/分类的爆文榜单 | 查2026-04-20化妆美容爆款 |\n| `查看更多`             | 获取完整50条榜单数据        | 查看更多                 |\n| `订阅`                 | 开通每日爆款推送            | 订阅                     |\n| `取消订阅`             | 关闭每日推送服务            | 取消订阅                 |\n\n---\n\n## 使用场景\n\n| 场景            | 角色               | 需求                                           | 使用方式                                                           |\n| --------------- | ------------------ | ---------------------------------------------- | ------------------------------------------------------------------ |\n| 找对标内容      | 0粉新手美妆博主    | 不知道小账号做什么内容能爆，头部博主参考性太低 | 每天查询美妆类单日爆发榜，拆解标题/内容/封面，模仿同款内容做差异化 |\n| 品牌运营跟热点  | 快消品牌小红书运营 | 跟进平台最新热点，做符合用户喜好的营销内容     | 订阅每日推送，提取热门关键词和内容形式融入品牌推广                 |\n| MCN挖掘潜力新人 | MCN内容星探        | 挖掘还没火的潜力博主，降低签约成本             | 每天查看全分类单日爆发榜，筛选高互动新账号重点关注                 |\n| 内容策划找灵感  | 内容策划/文案编辑  | 快速了解平台近期热门内容方向，为选题提供参考   | 按分类查询当日爆发榜，分析爆款共性特征总结模版                     |\n\n---\n\n## 项目架构\n\n### 目录结构\n\n```\nxhs-daily-ranking/\n├── scripts/\n│   ├── xhs_daily_fetcher.py   # 数据拉取、榜单生成核心脚本\n│   └── gen_xhs_html.py        # HTML可视化文件生成脚本\n├── references/\n│   └── core_workflow.md       # 完整功能流程规范（核心）\n├── requirements.txt           # 依赖声明\n└── SKILL.md                  # Skill定义文档\n```\n\n### 技术栈\n\n- **运行环境**：Python 3.8+\n- **依赖库**：requests>=2.28.0\n- **输出格式**：Markdown / HTML\n- **数据来源**：小红书公开内容接口\n\n### 数据流转\n\n```\n用户请求 → 参数校验（日期/分类匹配） → 调用公开接口拉取数据\n    ↓\n生成Markdown榜单 → 规律分析 → 渲染HTML文件\n    ↓\n返回4项结果（榜单 + 分析 + HTML + 订阅选项）→ 用户响应\n```\n\n---\n\n## ⚠️ 输出规范（重要）\n\n> 完整功能流程规范见 [references/core_workflow.md](references/core_workflow.md)\n\n### 触发前提（强制，禁止违反）\n\n- **禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息**\n- 只有当用户主动输入关键词、分类名或明确表达查询意图时，才可调用脚本获取数据\n- **禁止主动向用户推送热榜数据、禁止在闲聊或无关对话中自动调用接口**\n\n### 四项输出内容（强制执行）\n\n| 序号 | 输出内容            | 要求                           |\n| ---- | ------------------- | ------------------------------ |\n| 1    | 🔥 单日爆发榜       | 含更新时间，禁止折叠，禁止遗漏 |\n| 2    | 📊 单日爆发笔记分析 | 3个模块，禁止折叠，禁止遗漏    |\n| 3    | 📁 HTML页面         | 直接输出页面，禁止只输出路径   |\n| 4    | 🔔 订阅服务         | HTML页面后立即输出，禁止跳过   |\n\n### 输出格式要求（强制执行）\n\n- **禁止折叠输出**：所有内容必须直接完整输出\n- **禁止输出文件**：除HTML页面外，禁止输出任何其他文件\n- **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务\n\n### 执行脚本命令\n\n```bash\n# 获取榜单数据（最多50条）\npython scripts/xhs_daily_fetcher.py --keyword \"{关键词}\" --top_n 50\n\n# 生成HTML页面\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20   # 首次输出\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50   # 查看更多\n```\n\n---\n\n## 资源索引\n\n| 资源         | 路径                           | 说明                             |\n| ------------ | ------------------------------ | -------------------------------- |\n| 完整流程规范 | `references/core_workflow.md`  | 详细输出规范、操作步骤、使用示例 |\n| 数据获取脚本 | `scripts/xhs_daily_fetcher.py` | 获取小红书爆款内容榜单数据       |\n| HTML生成脚本 | `scripts/gen_xhs_html.py`      | 生成可视化HTML页面               |\n\n---\n\n### 订阅服务内容（必须原样输出，禁止修改，禁止省略）\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"xhs-daily-ranking\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1778239508660\n}\n\nFile v1.0.3:references/core_workflow.md\n\n# 小红书每日风向标\n\n## 任务目标\n\n- 本 Skill 用于：获取小红书平台爆款内容榜单数据\n- 能力包含：\n  - 单日爆发榜数据获取（按分类查询）\n  - 单日热门笔记智能分析\n  - 冷门爆款笔记挖掘（关键词匹配分类）\n  - 订阅服务（每日定时推送）\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\n\n## 数据接口更新规则\n\n- **更新时间**：每天19:00更新昨天的榜单数据\n- **数据范围**：当日的热门笔记TOP50\n- **分类覆盖**：25个垂直领域分类\n\n## 输出规范（强制执行）\n\n**触发前提（强制，禁止违反）**：\n\n- **禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息**\n- 只有当用户主动输入关键词、分类名或明确表达查询意图时，才可调用脚本获取数据\n- 仅订阅推送场景下，按订阅约定时间自动输出，其余场景一律等待用户主动触发\n- **禁止主动向用户推送热榜数据、禁止在闲聊或无关对话中自动调用接口**\n\n**数据一致性要求（重要）**：\n\n- 单日爆发榜表格与HTML页面数据必须完全一致（相同顺序、相同内容）\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\n- 禁止胡乱渲染或使用不同数据源\n\n**输出内容必须严格包含以下四部分，禁止遗漏或胡乱输出：**\n\n- **单日爆发榜（更新时间）**：必须直接输出，禁止折叠，禁止遗漏\n- **单日爆发笔记分析**：必须直接输出，禁止折叠，禁止遗漏\n- **HTML页面**：必须生成并输出，禁止折叠，禁止遗漏\n- **订阅服务**：必须在HTML页面之后强制输出，禁止跳过，禁止遗漏，禁止等待用户回复\n\n**输出格式要求（强制执行）**：\n\n- **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n- **禁止输出文件**：除HTML页面外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n- **HTML必须直接输出页面，禁止只输出文件路径**\n- **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务的顺序执行，禁止混乱输出\n\n### 第一部分：单日爆发榜（必须包含榜单的数据更新时间）\n\n**输出要求**：\n\n- 必须直接完整输出表格内容\n- 禁止折叠、隐藏或展开表格\n- 禁止输出为文件格式\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\n\n- 标题格式：**🔥 【{分类名称}】单日爆发榜 （更新时间：{查询日期} 19:00）**（标题整体加粗）\n- 标题示例：**🔥 【化妆美容】单日爆发榜 （更新时间：2026-04-21 19:00）**\n\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\n\n| 排名 | 笔记信息                                         |      互动数       |       点赞        |       评论       |       收藏       |       分享        |\n| :--: | :----------------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\n|  🥇  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 22w+<br>↑新增23w+ | 22w+<br>↑新增21w+ | 893<br>↑新增21w+ | 1w+<br>↑新增21w+ | 1w+<br>↑新增21w+  |\n|  🥈  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 20w+<br>↑新增18w+ | 18w+<br>↑新增16w+ | 756<br>↑新增18w+ | 8k+<br>↑新增16w+ | 900+<br>↑新增16w+ |\n|  🥉  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 18w+<br>↑新增15w+ | 15w+<br>↑新增13w+ | 621<br>↑新增15w+ | 7k+<br>↑新增13w+ | 800+<br>↑新增13w+ |\n\n**字段详细说明**：\n\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\n- **笔记信息**：\n  - 第一行：笔记标题（可点击跳转）\n  - 第二行：[作者名](作者主页链接) 粉丝数+（作者名可点击跳转到作者主页，链接使用API返回的userJumpUrl字段，字号与标题一样大）\n- **互动数**：\n  - 第一行：累计互动数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **点赞**：\n  - 第一行：累计点赞数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **评论**：\n  - 第一行：累计评论数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **收藏**：\n  - 第一行：累计收藏数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **分享**：\n  - 第一行：累计分享数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n  - **分享字段必须展示且不能出错**\n\n**重要说明**：\n\n- 使用标准 Markdown 表格格式\n- 单元格内使用 `<br>` 换行显示累计数据和新增数据\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\n- 新增数据格式：累计数据 <br> ↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\n- \"↑新增\"文案字号比累计数据小一号\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\n\n**数据说明（必须在表格上方、标题之后输出）**：\n\n- 在单日爆发榜标题之后、表格之前输出：_单日爆发榜指笔记发后第3天比第2天涨的数据由高到低Top50_\n\n**数据输出逻辑（必须严格执行）**：\n\n- **首次输出**：\n  - 单日爆发榜表格：显示TOP1到TOP20\n  - HTML页面：显示TOP1到TOP20（与热榜表格保持一致）\n  - **\"查看更多\"提示逻辑**（必须严格执行）：\n    - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\n    - 如果返回数据 > 20条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"（显示剩余数据条数）\n    - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\n- **用户输入\"查看更多\"后**：\n  - 单日爆发榜表格：输出TOP21到实际数据末尾（延续之前的TOP20）\n  - HTML页面：输出TOP1到实际数据末尾（完整数据，覆盖之前的HTML文件）\n\n### 第二部分：单日爆发笔记分析\n\n**输出要求**：\n\n- 必须直接完整输出3个模块内容（热门内容分析、爆款标题分析、最高数据作品分析）\n- 禁止折叠、隐藏或展开任何模块\n- 禁止输出为文件格式\n- 所有分析内容都基于获取到的所有数据\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\n- **必须包含3个模块，禁止遗漏**\n\n- 标题格式：**📊 单日爆发笔记分析**（加粗，不带Top数量）\n- 示例：**📊 单日爆发笔记分析**\n\n以下内容分析基于获取的全部数据（共{数据条数}条）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征                                                                                                                                                                           | 实际效果      | 参考笔记                           |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]<br>[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望                           | 互动率提升50% | [笔记标题链接3]<br>[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查                         | 收藏率提升55% | [笔记标题链接5]<br>[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力                                     | 曝光率提升40% | [笔记标题链接7]<br>[笔记标题链接8] |\n\n**📈爆款标题分析**\n\n| 标题类型 | 标题特征                                                                                                           | 标题模版         | 发布规律             | 参考标题                 |\n| :------- | :----------------------------------------------------------------------------------------------------------------- | :--------------- | :------------------- | :----------------------- |\n| 提问式   | 标题以疑问句开头，设置悬念或提出用户关心的问题，引发用户的好奇心和思考欲望，激发点击阅读或评论互动                 | \"你还在XX吗？\"   | 工作日早高峰效果最佳 | 这个方法你还在用吗？     |\n| 数字式   | 标题中包含具体的数字、数量或统计数据，利用人们对量化信息的偏好，增强内容的可信度和专业感，让用户觉得内容有价值     | \"XX个XX技巧\"     | 午餐时间点击率高     | 5个快速提升XX的技巧      |\n| 情绪词   | 使用具有强烈情感色彩的词汇或网络流行语，如\"绝了\"、\"太XX了\"等，直接触发用户的情绪反应，引发点赞、评论或分享行为     | \"太XX了！忍不住\" | 晚间黄金时段转化高   | 太好用了！忍不住分享给你 |\n| 利益点   | 直接在标题中明确承诺用户可以获得的具体利益或效果，如\"XX天就能XX\"、\"省XX元\"等，降低用户决策成本，提高点击率和收藏率 | \"XX天就能XX\"     | 深夜发布收藏率最高   | 7天就能看到明显效果      |\n\n**✨最高数据作品分析**\n\n| 维度     | 核心特征分析                                               | 参考笔记       |\n| :------- | :--------------------------------------------------------- | :------------- |\n| 最高点赞 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n\n### 第三部分：HTML页面\n\n**强制要求（必须严格遵守）**：\n\n- HTML页面是4项输出中的第3项，必须在单日爆发榜和单日分析之后输出\n- 不需要等待用户回复，单日分析输出后立即执行\n- **禁止只输出文件路径，必须直接输出HTML页面**\n- **禁止折叠输出**\n- 这是唯一允许输出的文件，其他内容禁止输出为文件\n\n**执行命令**：\n\n- **首次输出**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\n- **用户输入\"查看更多\"后**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50`\n\n**文件特点**：\n\n- 可独立打开的HTML文件\n- 支持直接点击链接跳转\n- 支持导出图片和PDF功能（导出结果与页面显示完全一致，PDF和图片导出内容一定是正确的）\n- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为\"↑新增数值\"格式，整体字号增大1px\n- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据，分享字段必须展示且不能出错）\n\n## 数据输出逻辑详解\n\n**核心原则**：\n\n- 单日爆发榜表格与HTML页面必须保持数据一致性\n- 使用相同的API接口，禁止修改接口返回的顺序\n\n### 阶段一：首次输出\n\n1. **单日爆发榜表格**：\n   - 调用脚本获取数据（最多50条）\n   - 展示TOP1到TOP20（前20条）\n   - **\"查看更多\"提示逻辑（根据实际数据量动态调整）**：\n     - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\n     - 如果返回数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{实际剩余数量}条！✨\"\n     - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\n\n2. **HTML页面**：\n   - 执行命令：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\n   - 生成HTML文件，包含TOP1到TOP20数据\n   - 与单日爆发榜表格数据完全一致\n\n### 阶段二：用户输入\"查看更多\"\n\n1. **单日爆发榜表格**：\n   - 继续展示TOP21到实际数据末尾（根据实际数据量）\n   - 延续首次输出的数据，不重复TOP1-20\n\n### 第四部分：订阅服务（紧接HTML页面之后输出，禁止跳过）\n\n**强制要求（必须严格遵守）**：\n\n- 必须在HTML页面输出完成后展示\n- 提供每日19:30推送小红书单日热门笔记TOP50的订阅选项\n- 用户可回复数字或\"取消\"\n- **禁止遗漏，禁止胡乱输出**\n\n**订阅服务内容（必须原样输出，禁止修改，禁止省略）**：\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\n**订阅逻辑**：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n\n**输出顺序（严格按此顺序执行，禁止混乱输出，禁止遗漏）**：\n\n1. 🔥 单日爆发榜（含更新时间）\n2. 📊 单日爆发笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n3. 📁 HTML页面（直接输出，禁止只输出路径）\n4. 订阅服务（推送选项）\n\n**重要提示（强制，禁止违反）**：\n\n- **必须严格包含以上4项内容，禁止遗漏**\n  - 🔥 单日爆发榜（含更新时间）\n  - 📊 单日爆发笔记分析（3个模块）\n  - 📁 HTML页面（直接输出页面，输出后继续执行订阅服务）\n  - **订阅服务（推送选项，必须在HTML页面之后立即输出，禁止跳过，禁止遗漏）**\n- **禁止胡乱输出，禁止输出其他内容**\n- **禁止输出顺序混乱，必须严格按照上述顺序**\n- **订阅服务必须强制执行，HTML页面输出完成后必须立即展示订阅服务，不能等待用户回复，不能跳过，不能遗漏**\n\n### 数据一致性保障\n\n- 两个脚本使用相同的API接口\n- 相同的API接口，禁止修改接口返回的顺序\n- 相同的数据字段和格式\n- 确保表格和HTML页面的排名、数据完全一致（禁止修改接口返回的顺序）\n\n## 操作步骤\n\n### 标准流程\n\n#### 第一步：分类匹配\n\n根据用户输入自动匹配合适的分类：\n\n**可用分类列表（共25个）**：\n综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n\n**匹配规则**：\n\n- 用户输入具体产品词（如\"睫毛膏\"）→ 匹配对应分类（\"化妆美容\"）\n- 用户输入领域词（如\"穿搭\"、\"美食\"）→ 直接匹配分类\n- 未指定分类 → 使用\"综合全部\"\n\n**关键词-分类映射示例**：\n\n```\n睫毛膏/口红/粉底 → 化妆美容\n穿搭/衣服/时尚 → 时尚穿搭\n美食/做饭/探店 → 美味佳肴\n猫/狗/宠物 → 宠物天地\n游戏/王者/电竞 → 休闲娱乐\n```\n\n#### 第二步：查询冷门爆款笔记\n\n- 用户输入关键词后，自动匹配对应分类（**不告知用户匹配到的分类名称**）\n- 查询该分类下的冷门爆款笔记（最多50条）\n- **根据实际数据量动态展示**：\n  - 如果返回数据 ≤ 20条：默认展示全部数据，不展示\"查看更多\"提示\n  - 如果返回数据 > 20条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余{数量}条！✨\"提示\n  - 如果返回数据 = 50条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余30条！✨\"提示\n\n#### 第三步：日期判断\n\n根据用户输入和当前时间确定查询日期：\n\n**判断规则**：\n\n1. **用户指定了日期** → 直接使用指定日期\n2. **用户未指定日期**：\n   - 当前时间 >= 19:00 → 查询**昨日**数据（当日19:00已更新）\n   - 当前时间 < 19:00 → 查询**前天**数据（等待当日19:00更新）\n\n#### 第四步：获取单日爆发榜数据\n\n调用脚本获取榜单数据：\n\n```bash\npython scripts/xhs_daily_fetcher.py --keyword \"睫毛膏\" --top_n 50\n```\n\n**参数说明**：\n\n- `--category`：分类名称（可选）\n- `--keyword`：用户输入的关键词，用于自动匹配分类\n- `--rank_date`：查询日期（可选，自动判断）\n- `--top_n`：返回条数（默认50）\n\n**数据完整性要求**：\n\n- 确保表格所有字段和数据完整加载\n- 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\n- 直到所有字段（排名、笔记信息、互动数、点赞、评论、收藏、分享）都有完整数据\n- **分享字段使用正确的API字段名**：`AnaAddBean.useShareCount`（累计分享数）、`AnaAddBean.addShareCount`（新增分享数）\n- **确保分享数值正确输出，避免使用错误的字段名导致数值不对**\n\n#### 第五步：输出单日爆发榜和单日分析\n\n按照输出规范，依次输出：\n\n1. 单日爆发榜（含更新时间）\n2. 单日爆发笔记分析（3个模块）\n\n#### 第六步：生成HTML页面（4项输出中的第3项）\n\n**重要要求：HTML页面输出完成后必须继续执行第七步（订阅服务），HTML不是最后一步**\n\n生成可视化HTML页面：\n\n**首次输出时**：\n\n```bash\npython scripts/gen_xhs_html.py --keyword \"穿搭\" --top 20\n```\n\n**用户输入\"查看更多\"后**：\n\n```bash\npython scripts/gen_xhs_html.py --keyword \"穿搭\" --top 50\n```\n\n**输出格式（直接输出HTML页面，禁止只输出文件路径）**：\n\n#### 第七步：输出订阅服务（强制，禁止跳过，禁止遗漏）\n\n**必须在HTML页面输出完成后立即执行此步，不能等待用户回复，不能跳过，不能遗漏**\n\n直接输出以下内容（禁止修改，禁止省略）：\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\n**订阅逻辑**：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n\n## 订阅服务说明\n\n### 订阅内容\n\n**小红书单日爆发笔记推荐TOP50**\n\n- 每日19:30更新\n- 推送当日的50篇热门内容\n- 包含完整分析和HTML文件\n\n### 订阅输出格式\n\n按上述4项输出顺序执行即可，与标准输出格式一致。\n\n## 使用示例\n\n### 示例1：关键词查询\n\n- **场景/输入**：\"帮我查一下睫毛膏相关的爆款笔记\"\n- **预期产出**：匹配化妆美容分类，依次输出单日爆发榜、单日分析、HTML页面、订阅服务\n\n### 示例2：泛查询热门内容\n\n- **场景/输入**：\"最近小红书有什么热门内容\"\n- **预期产出**：使用综合全部分类，依次输出4项内容\n\n## 资源索引\n\n- **脚本**：见 [scripts/xhs_daily_fetcher.py](scripts/xhs_daily_fetcher.py)\n  - 用途：获取小红书爆款内容榜单数据\n  - 参数：--category 分类名 / --keyword 关键词 / --top_n 条数\n- **脚本**：见 [scripts/gen_xhs_html.py](scripts/gen_xhs_html.py)\n  - 用途：生成可视化HTML页面\n  - 参数：--category 分类名 / --top 条数 / --output 输出路径\n\n## 注意事项\n\n- 数据每日19:00更新昨天的榜单\n- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含单日爆发榜（更新时间）+ 单日爆发笔记分析 + HTML页面 + 订阅服务\n  - 🔥 单日爆发榜（必须包含更新时间）\n  - 📊 单日爆发笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n  - 📁 HTML页面（直接输出HTML页面，禁止只输出文件路径）\n  - **订阅服务（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复）**：🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n  - **禁止输出遗漏，禁止胡乱输出，必须严格按照此4项内容输出，订阅服务与其他3项同等强制**\n- **输出格式要求（强制）**：\n  - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n  - **禁止输出文件**：除HTML页面外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n  - **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务的顺序执行，禁止混乱输出\n- **输出顺序（严格按此顺序执行，禁止混乱输出）**：\n  1. **🔥 单日爆发榜**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）\n  2. **📊 单日爆发笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）\n  3. **📁 HTML页面**（4项输出中的第3项，直接输出HTML页面禁止只输出路径，输出后继续执行订阅服务）\n  4. **订阅服务（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复，与前三项同等强制）**：HTML页面输出完成后立即原样输出订阅服务文案\n- **HTML页面输出要求（强制）**：\n  - 是4项输出中的第3项，直接输出HTML页面，禁止只输出文件路径\n  - **禁止只输出文件路径，必须直接输出HTML页面**\n  - **禁止折叠输出**\n  - **PDF和图片导出内容一定是正确的**\n  - 不需要等待任何流程\n- **订阅服务输出要求（强制，禁止遗漏）**：\n  - 订阅服务是4项输出内容之一，与其他3项同等强制，禁止遗漏\n  - 必须在HTML页面输出完成后立即展示，不能等待用户回复\n  - **禁止跳过，禁止遗漏，禁止等待用户回复，禁止折叠**\n  - 提供订阅选项：每日19:30推送小红书单日爆发笔记TOP50 或 暂不需要-仅本次查询\n  - 订阅逻辑：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n  - 请用户回复数字或\"取消\"\n- **数据一致性要求**：单日爆发榜表格与HTML页面必须使用相同的数据源，禁止修改接口返回的顺序，确保完全一致\n- **数据完整性要求（强制）**：\n  - 表格所有字段和数据必须完整加载\n  - 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\n  - 直到所有字段都有完整数据（单日爆发榜7个字段、单日分析所有表格字段）\n- **数据输出逻辑（必须严格执行）**：\n  - 首次输出：单日爆发榜TOP1-20，HTML页面TOP1-20（保持一致）\n  - 查看更多：单日爆发榜TOP21-实际数据末尾，HTML页面TOP1-实际数据末尾（完整数据）\n  - **\"查看更多\"提示逻辑**：\n    - 数据 ≤ 20条：不展示\n    - 数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"\n    - 数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"\n- 表格字段：排名、笔记信息、互动数（新增互动）、点赞（新增点赞）、评论（新增评论）、收藏（新增收藏）、分享（新增分享，**必须展示且不能出错，避免胡乱输出**）\n- 单日分析包含：热门内容分析、爆款标题分析、最高数据作品分析\n- 单日分析标题后显示\"以下内容分析基于获取的全部数据（共{数据条数}条）进行~\"\n- 分析内容从创作者视角出发，提供可执行建议\n- **禁止自动查询**：未订阅且未收到用户明确查询输入时，禁止自动调用脚本或输出任何热榜信息\n\nFile v1.0.3:_skillhub_meta.json\n\n{\n  \"name\": \"xhs-daily-ranking\",\n  \"installedAt\": 1777449681027,\n  \"source\": \"import\"\n}\n\nArchive v1.0.2: 7 files, 40928 bytes\n\nFiles: _skillhub_meta.json (87b), references/core_workflow.md (25138b), scripts/gen_xhs_html.py (30466b), scripts/xhs_daily_fetcher.py (26331b), scripts/xhs_weekly.html (37151b), SKILL.md (9536b), _meta.json (136b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: xhs-daily-ranking\ndescription: 获取小红书平台单日爆发榜单数据，支持按分类查询当日热门笔记；当用户需要查询小红书当日热门内容、分析单日爆款笔记、了解各领域当日趋势或获取创作灵感时使用\n---\n\n# 小红书单日爆发榜\n\n---\n\n## 简介\n\n小红书单日爆发榜是一款专为内容创作者和营销人员设计的智能工具，帮助用户实时追踪小红书平台当日的爆款笔记数据。\n\n通过简单的关键词查询，你可以：\n\n- 🔥 获取每日单日爆发榜TOP50，解决「不知道今天什么内容在爆」的痛点\n- 📊 自动分析爆款特征和规律，解决「找爆文、拆规律效率低」的痛点\n- 📁 生成可视化HTML页面，一键导出分享，大幅降低内容分析成本\n- 🔔 支持每日固定时间订阅推送，不用手动重复查询\n\n适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。\n\n**技术基础**：基于小红书公开内容接口，每日19:00更新昨日榜单数据。\n\n---\n\n## 功能特性\n\n### 🎯 核心功能\n\n- **🔥 单日爆发榜查询**：获取当日热门笔记TOP50，按分类查询，支持25个垂直领域精准匹配\n- **📊 智能规律分析**：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告\n- **📈 多维度数据展示**：完整呈现互动数、点赞、评论、收藏、分享及新增数据\n- **🔔 自动订阅推送**：支持每日19:30固定时间推送最新榜单到消息栏\n\n### ✨ 特色亮点\n\n- **⏰ 智能日期适配**：支持指定日期或模糊日期查询，自动按规则匹配近2天数据\n- **📤 多格式输出**：自动生成Markdown表格+HTML可视化文件，支持导出PDF/图片\n- **🔗 一键跳转**：笔记和作者主页可直接点击跳转，查看原内容更便捷\n- **⚡ 无额外门槛**：无需小红书账号、无需API密钥，安装依赖即可使用\n\n## 使用指南\n\n### 基础使用（3步）\n\n#### 1. 发起查询\n\n告诉工具你要查询的分类或关键词（未指定日期则自动按规则匹配近2天数据）：\n\n> 用户：帮我查一下睫毛膏相关的爆款笔记\n>\n> 助手：正在为你查询化妆美容分类的单日爆发榜数据...\n\n#### 2. 查看完整输出\n\n系统自动输出4项内容（完整流程规范见 [references/core_workflow.md](references/core_workflow.md)）：\n\n| 序号 | 输出内容            | 说明                                         |\n| ---- | ------------------- | -------------------------------------------- |\n| 1    | 🔥 单日爆发榜       | 含更新时间，展示TOP20数据                    |\n| 2    | 📊 单日爆发笔记分析 | 热门内容分析、爆款标题分析、最高数据作品分析 |\n| 3    | 📁 HTML页面         | 直接输出可视化页面，支持导出PDF/图片         |\n| 4    | 🔔 订阅服务         | 每日19:30推送选项                            |\n\n#### 3. 查看更多数据\n\n默认输出TOP20内容，输入「查看更多」即可获取全部50条内容：\n\n> 用户：查看更多\n>\n> 助手：为你展示全部50条单日爆发笔记...\n\n---\n\n### 高级使用（4步）\n\n#### 1. 分类匹配规则（内部执行）\n\n系统会根据用户输入自动匹配合适的分类，分类匹配逻辑在执行时内部完成，不直接向用户展示具体映射规则或匹配细节。\n\n如需查看完整匹配规范，请参考 `references/core_workflow.md`。\n\n#### 2. 日期判断规则\n\n- 用户指定了日期 → 直接使用指定日期\n- 用户未指定日期：\n  - 当前时间 >= 19:00 → 查询**昨日**数据\n  - 当前时间 < 19:00 → 查询**前天**数据\n\n#### 3. 数据输出逻辑\n\n| 阶段     | 单日爆发榜 | HTML页面          | 提示                          |\n| -------- | ---------- | ----------------- | ----------------------------- |\n| 首次输出 | TOP1-20    | TOP1-20           | 数据>20条时显示\"查看更多\"提示 |\n| 查看更多 | TOP21-末尾 | TOP1-末尾（完整） | -                             |\n\n#### 4. 数据一致性保障\n\n- 单日爆发榜表格与HTML页面必须使用相同数据源\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\n\n---\n\n### 命令速查表\n\n| 命令                   | 功能                        | 示例                     |\n| ---------------------- | --------------------------- | ------------------------ |\n| `查[关键词]爆款`       | 查询指定分类的单日爆发榜    | 查睫毛膏爆款             |\n| `查[日期][关键词]爆款` | 查询指定日期/分类的爆文榜单 | 查2026-04-20化妆美容爆款 |\n| `查看更多`             | 获取完整50条榜单数据        | 查看更多                 |\n| `订阅`                 | 开通每日爆款推送            | 订阅                     |\n| `取消订阅`             | 关闭每日推送服务            | 取消订阅                 |\n\n---\n\n## 使用场景\n\n| 场景            | 角色               | 需求                                           | 使用方式                                                           |\n| --------------- | ------------------ | ---------------------------------------------- | ------------------------------------------------------------------ |\n| 找对标内容      | 0粉新手美妆博主    | 不知道小账号做什么内容能爆，头部博主参考性太低 | 每天查询美妆类单日爆发榜，拆解标题/内容/封面，模仿同款内容做差异化 |\n| 品牌运营跟热点  | 快消品牌小红书运营 | 跟进平台最新热点，做符合用户喜好的营销内容     | 订阅每日推送，提取热门关键词和内容形式融入品牌推广                 |\n| MCN挖掘潜力新人 | MCN内容星探        | 挖掘还没火的潜力博主，降低签约成本             | 每天查看全分类单日爆发榜，筛选高互动新账号重点关注                 |\n| 内容策划找灵感  | 内容策划/文案编辑  | 快速了解平台近期热门内容方向，为选题提供参考   | 按分类查询当日爆发榜，分析爆款共性特征总结模版                     |\n\n---\n\n## 项目架构\n\n### 目录结构\n\n```\nxhs-daily-ranking/\n├── scripts/\n│   ├── xhs_daily_fetcher.py   # 数据拉取、榜单生成核心脚本\n│   └── gen_xhs_html.py        # HTML可视化文件生成脚本\n├── references/\n│   └── core_workflow.md       # 完整功能流程规范（核心）\n├── requirements.txt           # 依赖声明\n└── SKILL.md                  # Skill定义文档\n```\n\n### 技术栈\n\n- **运行环境**：Python 3.8+\n- **依赖库**：requests>=2.28.0\n- **输出格式**：Markdown / HTML\n- **数据来源**：小红书公开内容接口\n\n### 数据流转\n\n```\n用户请求 → 参数校验（日期/分类匹配） → 调用公开接口拉取数据\n    ↓\n生成Markdown榜单 → 规律分析 → 渲染HTML文件\n    ↓\n返回4项结果（榜单 + 分析 + HTML + 订阅选项）→ 用户响应\n```\n\n---\n\n## ⚠️ 输出规范（重要）\n\n> 完整功能流程规范见 [references/core_workflow.md](references/core_workflow.md)\n\n### 触发前提（强制，禁止违反）\n\n- **禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息**\n- 只有当用户主动输入关键词、分类名或明确表达查询意图时，才可调用脚本获取数据\n- **禁止主动向用户推送热榜数据、禁止在闲聊或无关对话中自动调用接口**\n\n### 四项输出内容（强制执行）\n\n| 序号 | 输出内容            | 要求                           |\n| ---- | ------------------- | ------------------------------ |\n| 1    | 🔥 单日爆发榜       | 含更新时间，禁止折叠，禁止遗漏 |\n| 2    | 📊 单日爆发笔记分析 | 3个模块，禁止折叠，禁止遗漏    |\n| 3    | 📁 HTML页面         | 直接输出页面，禁止只输出路径   |\n| 4    | 🔔 订阅服务         | HTML页面后立即输出，禁止跳过   |\n\n### 输出格式要求（强制执行）\n\n- **禁止折叠输出**：所有内容必须直接完整输出\n- **禁止输出文件**：除HTML页面外，禁止输出任何其他文件\n- **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务\n\n### 执行脚本命令\n\n```bash\n# 获取榜单数据（最多50条）\npython scripts/xhs_daily_fetcher.py --keyword \"{关键词}\" --top_n 50\n\n# 生成HTML页面\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20   # 首次输出\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50   # 查看更多\n```\n\n---\n\n## 资源索引\n\n| 资源         | 路径                           | 说明                             |\n| ------------ | ------------------------------ | -------------------------------- |\n| 完整流程规范 | `references/core_workflow.md`  | 详细输出规范、操作步骤、使用示例 |\n| 数据获取脚本 | `scripts/xhs_daily_fetcher.py` | 获取小红书爆款内容榜单数据       |\n| HTML生成脚本 | `scripts/gen_xhs_html.py`      | 生成可视化HTML页面               |\n\n---\n\n### 订阅服务内容（必须原样输出，禁止修改，禁止省略）\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"xhs-daily-ranking\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1777465715655\n}\n\nFile v1.0.2:references/core_workflow.md\n\n# 小红书单日爆发榜\n\n## 任务目标\n\n- 本 Skill 用于：获取小红书平台爆款内容榜单数据\n- 能力包含：\n  - 单日爆发榜数据获取（按分类查询）\n  - 单日热门笔记智能分析\n  - 冷门爆款笔记挖掘（关键词匹配分类）\n  - 订阅服务（每日定时推送）\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\n\n## 数据接口更新规则\n\n- **更新时间**：每天19:00更新昨天的榜单数据\n- **数据范围**：当日的热门笔记TOP50\n- **分类覆盖**：25个垂直领域分类\n\n## 输出规范（强制执行）\n\n**触发前提（强制，禁止违反）**：\n\n- **禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息**\n- 只有当用户主动输入关键词、分类名或明确表达查询意图时，才可调用脚本获取数据\n- 仅订阅推送场景下，按订阅约定时间自动输出，其余场景一律等待用户主动触发\n- **禁止主动向用户推送热榜数据、禁止在闲聊或无关对话中自动调用接口**\n\n**数据一致性要求（重要）**：\n\n- 单日爆发榜表格与HTML页面数据必须完全一致（相同顺序、相同内容）\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\n- 禁止胡乱渲染或使用不同数据源\n\n**输出内容必须严格包含以下四部分，禁止遗漏或胡乱输出：**\n\n- **单日爆发榜（更新时间）**：必须直接输出，禁止折叠，禁止遗漏\n- **单日爆发笔记分析**：必须直接输出，禁止折叠，禁止遗漏\n- **HTML页面**：必须生成并输出，禁止折叠，禁止遗漏\n- **订阅服务**：必须在HTML页面之后强制输出，禁止跳过，禁止遗漏，禁止等待用户回复\n\n**输出格式要求（强制执行）**：\n\n- **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n- **禁止输出文件**：除HTML页面外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n- **HTML必须直接输出页面，禁止只输出文件路径**\n- **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务的顺序执行，禁止混乱输出\n\n### 第一部分：单日爆发榜（必须包含榜单的数据更新时间）\n\n**输出要求**：\n\n- 必须直接完整输出表格内容\n- 禁止折叠、隐藏或展开表格\n- 禁止输出为文件格式\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\n\n- 标题格式：**🔥 【{分类名称}】单日爆发榜 （更新时间：{查询日期} 19:00）**（标题整体加粗）\n- 标题示例：**🔥 【化妆美容】单日爆发榜 （更新时间：2026-04-21 19:00）**\n\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\n\n| 排名 | 笔记信息                                         |      互动数       |       点赞        |       评论       |       收藏       |       分享        |\n| :--: | :----------------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\n|  🥇  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 22w+<br>↑新增23w+ | 22w+<br>↑新增21w+ | 893<br>↑新增21w+ | 1w+<br>↑新增21w+ | 1w+<br>↑新增21w+  |\n|  🥈  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 20w+<br>↑新增18w+ | 18w+<br>↑新增16w+ | 756<br>↑新增18w+ | 8k+<br>↑新增16w+ | 900+<br>↑新增16w+ |\n|  🥉  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 18w+<br>↑新增15w+ | 15w+<br>↑新增13w+ | 621<br>↑新增15w+ | 7k+<br>↑新增13w+ | 800+<br>↑新增13w+ |\n\n**字段详细说明**：\n\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\n- **笔记信息**：\n  - 第一行：笔记标题（可点击跳转）\n  - 第二行：[作者名](作者主页链接) 粉丝数+（作者名可点击跳转到作者主页，链接使用API返回的userJumpUrl字段，字号与标题一样大）\n- **互动数**：\n  - 第一行：累计互动数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **点赞**：\n  - 第一行：累计点赞数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **评论**：\n  - 第一行：累计评论数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **收藏**：\n  - 第一行：累计收藏数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **分享**：\n  - 第一行：累计分享数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n  - **分享字段必须展示且不能出错**\n\n**重要说明**：\n\n- 使用标准 Markdown 表格格式\n- 单元格内使用 `<br>` 换行显示累计数据和新增数据\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\n- 新增数据格式：累计数据 <br> ↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\n- \"↑新增\"文案字号比累计数据小一号\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\n\n**数据说明（必须在表格上方、标题之后输出）**：\n\n- 在单日爆发榜标题之后、表格之前输出：_单日爆发榜指笔记发后第3天比第2天涨的数据由高到低Top50_\n\n**数据输出逻辑（必须严格执行）**：\n\n- **首次输出**：\n  - 单日爆发榜表格：显示TOP1到TOP20\n  - HTML页面：显示TOP1到TOP20（与热榜表格保持一致）\n  - **\"查看更多\"提示逻辑**（必须严格执行）：\n    - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\n    - 如果返回数据 > 20条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"（显示剩余数据条数）\n    - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\n- **用户输入\"查看更多\"后**：\n  - 单日爆发榜表格：输出TOP21到实际数据末尾（延续之前的TOP20）\n  - HTML页面：输出TOP1到实际数据末尾（完整数据，覆盖之前的HTML文件）\n\n### 第二部分：单日爆发笔记分析\n\n**输出要求**：\n\n- 必须直接完整输出3个模块内容（热门内容分析、爆款标题分析、最高数据作品分析）\n- 禁止折叠、隐藏或展开任何模块\n- 禁止输出为文件格式\n- 所有分析内容都基于获取到的所有数据\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\n- **必须包含3个模块，禁止遗漏**\n\n- 标题格式：**📊 单日爆发笔记分析**（加粗，不带Top数量）\n- 示例：**📊 单日爆发笔记分析**\n\n以下内容分析基于获取的全部数据（共{数据条数}条）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征                                                                                                                                                                           | 实际效果      | 参考笔记                           |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]<br>[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望                           | 互动率提升50% | [笔记标题链接3]<br>[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查                         | 收藏率提升55% | [笔记标题链接5]<br>[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力                                     | 曝光率提升40% | [笔记标题链接7]<br>[笔记标题链接8] |\n\n**📈爆款标题分析**\n\n| 标题类型 | 标题特征                                                                                                           | 标题模版         | 发布规律             | 参考标题                 |\n| :------- | :----------------------------------------------------------------------------------------------------------------- | :--------------- | :------------------- | :----------------------- |\n| 提问式   | 标题以疑问句开头，设置悬念或提出用户关心的问题，引发用户的好奇心和思考欲望，激发点击阅读或评论互动                 | \"你还在XX吗？\"   | 工作日早高峰效果最佳 | 这个方法你还在用吗？     |\n| 数字式   | 标题中包含具体的数字、数量或统计数据，利用人们对量化信息的偏好，增强内容的可信度和专业感，让用户觉得内容有价值     | \"XX个XX技巧\"     | 午餐时间点击率高     | 5个快速提升XX的技巧      |\n| 情绪词   | 使用具有强烈情感色彩的词汇或网络流行语，如\"绝了\"、\"太XX了\"等，直接触发用户的情绪反应，引发点赞、评论或分享行为     | \"太XX了！忍不住\" | 晚间黄金时段转化高   | 太好用了！忍不住分享给你 |\n| 利益点   | 直接在标题中明确承诺用户可以获得的具体利益或效果，如\"XX天就能XX\"、\"省XX元\"等，降低用户决策成本，提高点击率和收藏率 | \"XX天就能XX\"     | 深夜发布收藏率最高   | 7天就能看到明显效果      |\n\n**✨最高数据作品分析**\n\n| 维度     | 核心特征分析                                               | 参考笔记       |\n| :------- | :--------------------------------------------------------- | :------------- |\n| 最高点赞 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n\n### 第三部分：HTML页面\n\n**强制要求（必须严格遵守）**：\n\n- HTML页面是4项输出中的第3项，必须在单日爆发榜和单日分析之后输出\n- 不需要等待用户回复，单日分析输出后立即执行\n- **禁止只输出文件路径，必须直接输出HTML页面**\n- **禁止折叠输出**\n- 这是唯一允许输出的文件，其他内容禁止输出为文件\n\n**执行命令**：\n\n- **首次输出**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\n- **用户输入\"查看更多\"后**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50`\n\n**文件特点**：\n\n- 可独立打开的HTML文件\n- 支持直接点击链接跳转\n- 支持导出图片和PDF功能（导出结果与页面显示完全一致，PDF和图片导出内容一定是正确的）\n- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为\"↑新增数值\"格式，整体字号增大1px\n- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据，分享字段必须展示且不能出错）\n\n## 数据输出逻辑详解\n\n**核心原则**：\n\n- 单日爆发榜表格与HTML页面必须保持数据一致性\n- 使用相同的API接口，禁止修改接口返回的顺序\n\n### 阶段一：首次输出\n\n1. **单日爆发榜表格**：\n   - 调用脚本获取数据（最多50条）\n   - 展示TOP1到TOP20（前20条）\n   - **\"查看更多\"提示逻辑（根据实际数据量动态调整）**：\n     - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\n     - 如果返回数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{实际剩余数量}条！✨\"\n     - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\n\n2. **HTML页面**：\n   - 执行命令：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\n   - 生成HTML文件，包含TOP1到TOP20数据\n   - 与单日爆发榜表格数据完全一致\n\n### 阶段二：用户输入\"查看更多\"\n\n1. **单日爆发榜表格**：\n   - 继续展示TOP21到实际数据末尾（根据实际数据量）\n   - 延续首次输出的数据，不重复TOP1-20\n\n### 第四部分：订阅服务（紧接HTML页面之后输出，禁止跳过）\n\n**强制要求（必须严格遵守）**：\n\n- 必须在HTML页面输出完成后展示\n- 提供每日19:30推送小红书单日热门笔记TOP50的订阅选项\n- 用户可回复数字或\"取消\"\n- **禁止遗漏，禁止胡乱输出**\n\n**订阅服务内容（必须原样输出，禁止修改，禁止省略）**：\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\n**订阅逻辑**：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n\n**输出顺序（严格按此顺序执行，禁止混乱输出，禁止遗漏）**：\n\n1. 🔥 单日爆发榜（含更新时间）\n2. 📊 单日爆发笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n3. 📁 HTML页面（直接输出，禁止只输出路径）\n4. 订阅服务（推送选项）\n\n**重要提示（强制，禁止违反）**：\n\n- **必须严格包含以上4项内容，禁止遗漏**\n  - 🔥 单日爆发榜（含更新时间）\n  - 📊 单日爆发笔记分析（3个模块）\n  - 📁 HTML页面（直接输出页面，输出后继续执行订阅服务）\n  - **订阅服务（推送选项，必须在HTML页面之后立即输出，禁止跳过，禁止遗漏）**\n- **禁止胡乱输出，禁止输出其他内容**\n- **禁止输出顺序混乱，必须严格按照上述顺序**\n- **订阅服务必须强制执行，HTML页面输出完成后必须立即展示订阅服务，不能等待用户回复，不能跳过，不能遗漏**\n\n### 数据一致性保障\n\n- 两个脚本使用相同的API接口\n- 相同的API接口，禁止修改接口返回的顺序\n- 相同的数据字段和格式\n- 确保表格和HTML页面的排名、数据完全一致（禁止修改接口返回的顺序）\n\n## 操作步骤\n\n### 标准流程\n\n#### 第一步：分类匹配\n\n根据用户输入自动匹配合适的分类：\n\n**可用分类列表（共25个）**：\n综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n\n**匹配规则**：\n\n- 用户输入具体产品词（如\"睫毛膏\"）→ 匹配对应分类（\"化妆美容\"）\n- 用户输入领域词（如\"穿搭\"、\"美食\"）→ 直接匹配分类\n- 未指定分类 → 使用\"综合全部\"\n\n**关键词-分类映射示例**：\n\n```\n睫毛膏/口红/粉底 → 化妆美容\n穿搭/衣服/时尚 → 时尚穿搭\n美食/做饭/探店 → 美味佳肴\n猫/狗/宠物 → 宠物天地\n游戏/王者/电竞 → 休闲娱乐\n```\n\n#### 第二步：查询冷门爆款笔记\n\n- 用户输入关键词后，自动匹配对应分类（**不告知用户匹配到的分类名称**）\n- 查询该分类下的冷门爆款笔记（最多50条）\n- **根据实际数据量动态展示**：\n  - 如果返回数据 ≤ 20条：默认展示全部数据，不展示\"查看更多\"提示\n  - 如果返回数据 > 20条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余{数量}条！✨\"提示\n  - 如果返回数据 = 50条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余30条！✨\"提示\n\n#### 第三步：日期判断\n\n根据用户输入和当前时间确定查询日期：\n\n**判断规则**：\n\n1. **用户指定了日期** → 直接使用指定日期\n2. **用户未指定日期**：\n   - 当前时间 >= 19:00 → 查询**昨日**数据（当日19:00已更新）\n   - 当前时间 < 19:00 → 查询**前天**数据（等待当日19:00更新）\n\n#### 第四步：获取单日爆发榜数据\n\n调用脚本获取榜单数据：\n\n```bash\npython scripts/xhs_daily_fetcher.py --keyword \"睫毛膏\" --top_n 50\n```\n\n**参数说明**：\n\n- `--category`：分类名称（可选）\n- `--keyword`：用户输入的关键词，用于自动匹配分类\n- `--rank_date`：查询日期（可选，自动判断）\n- `--top_n`：返回条数（默认50）\n\n**数据完整性要求**：\n\n- 确保表格所有字段和数据完整加载\n- 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\n- 直到所有字段（排名、笔记信息、互动数、点赞、评论、收藏、分享）都有完整数据\n- **分享字段使用正确的API字段名**：`AnaAddBean.useShareCount`（累计分享数）、`AnaAddBean.addShareCount`（新增分享数）\n- **确保分享数值正确输出，避免使用错误的字段名导致数值不对**\n\n#### 第五步：输出单日爆发榜和单日分析\n\n按照输出规范，依次输出：\n\n1. 单日爆发榜（含更新时间）\n2. 单日爆发笔记分析（3个模块）\n\n#### 第六步：生成HTML页面（4项输出中的第3项）\n\n**重要要求：HTML页面输出完成后必须继续执行第七步（订阅服务），HTML不是最后一步**\n\n生成可视化HTML页面：\n\n**首次输出时**：\n\n```bash\npython scripts/gen_xhs_html.py --keyword \"穿搭\" --top 20\n```\n\n**用户输入\"查看更多\"后**：\n\n```bash\npython scripts/gen_xhs_html.py --keyword \"穿搭\" --top 50\n```\n\n**输出格式（直接输出HTML页面，禁止只输出文件路径）**：\n\n#### 第七步：输出订阅服务（强制，禁止跳过，禁止遗漏）\n\n**必须在HTML页面输出完成后立即执行此步，不能等待用户回复，不能跳过，不能遗漏**\n\n直接输出以下内容（禁止修改，禁止省略）：\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\n**订阅逻辑**：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n\n## 订阅服务说明\n\n### 订阅内容\n\n**小红书单日爆发笔记推荐TOP50**\n\n- 每日19:30更新\n- 推送当日的50篇热门内容\n- 包含完整分析和HTML文件\n\n### 订阅输出格式\n\n按上述4项输出顺序执行即可，与标准输出格式一致。\n\n## 使用示例\n\n### 示例1：关键词查询\n\n- **场景/输入**：\"帮我查一下睫毛膏相关的爆款笔记\"\n- **预期产出**：匹配化妆美容分类，依次输出单日爆发榜、单日分析、HTML页面、订阅服务\n\n### 示例2：泛查询热门内容\n\n- **场景/输入**：\"最近小红书有什么热门内容\"\n- **预期产出**：使用综合全部分类，依次输出4项内容\n\n## 资源索引\n\n- **脚本**：见 [scripts/xhs_daily_fetcher.py](scripts/xhs_daily_fetcher.py)\n  - 用途：获取小红书爆款内容榜单数据\n  - 参数：--category 分类名 / --keyword 关键词 / --top_n 条数\n- **脚本**：见 [scripts/gen_xhs_html.py](scripts/gen_xhs_html.py)\n  - 用途：生成可视化HTML页面\n  - 参数：--category 分类名 / --top 条数 / --output 输出路径\n\n## 注意事项\n\n- 数据每日19:00更新昨天的榜单\n- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含单日爆发榜（更新时间）+ 单日爆发笔记分析 + HTML页面 + 订阅服务\n  - 🔥 单日爆发榜（必须包含更新时间）\n  - 📊 单日爆发笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n  - 📁 HTML页面（直接输出HTML页面，禁止只输出文件路径）\n  - **订阅服务（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复）**：🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n  - **禁止输出遗漏，禁止胡乱输出，必须严格按照此4项内容输出，订阅服务与其他3项同等强制**\n- **输出格式要求（强制）**：\n  - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n  - **禁止输出文件**：除HTML页面外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n  - **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务的顺序执行，禁止混乱输出\n- **输出顺序（严格按此顺序执行，禁止混乱输出）**：\n  1. **🔥 单日爆发榜**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）\n  2. **📊 单日爆发笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）\n  3. **📁 HTML页面**（4项输出中的第3项，直接输出HTML页面禁止只输出路径，输出后继续执行订阅服务）\n  4. **订阅服务（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复，与前三项同等强制）**：HTML页面输出完成后立即原样输出订阅服务文案\n- **HTML页面输出要求（强制）**：\n  - 是4项输出中的第3项，直接输出HTML页面，禁止只输出文件路径\n  - **禁止只输出文件路径，必须直接输出HTML页面**\n  - **禁止折叠输出**\n  - **PDF和图片导出内容一定是正确的**\n  - 不需要等待任何流程\n- **订阅服务输出要求（强制，禁止遗漏）**：\n  - 订阅服务是4项输出内容之一，与其他3项同等强制，禁止遗漏\n  - 必须在HTML页面输出完成后立即展示，不能等待用户回复\n  - **禁止跳过，禁止遗漏，禁止等待用户回复，禁止折叠**\n  - 提供订阅选项：每日19:30推送小红书单日爆发笔记TOP50 或 暂不需要-仅本次查询\n  - 订阅逻辑：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n  - 请用户回复数字或\"取消\"\n- **数据一致性要求**：单日爆发榜表格与HTML页面必须使用相同的数据源，禁止修改接口返回的顺序，确保完全一致\n- **数据完整性要求（强制）**：\n  - 表格所有字段和数据必须完整加载\n  - 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\n  - 直到所有字段都有完整数据（单日爆发榜7个字段、单日分析所有表格字段）\n- **数据输出逻辑（必须严格执行）**：\n  - 首次输出：单日爆发榜TOP1-20，HTML页面TOP1-20（保持一致）\n  - 查看更多：单日爆发榜TOP21-实际数据末尾，HTML页面TOP1-实际数据末尾（完整数据）\n  - **\"查看更多\"提示逻辑**：\n    - 数据 ≤ 20条：不展示\n    - 数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"\n    - 数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"\n- 表格字段：排名、笔记信息、互动数（新增互动）、点赞（新增点赞）、评论（新增评论）、收藏（新增收藏）、分享（新增分享，**必须展示且不能出错，避免胡乱输出**）\n- 单日分析包含：热门内容分析、爆款标题分析、最高数据作品分析\n- 单日分析标题后显示\"以下内容分析基于获取的全部数据（共{数据条数}条）进行~\"\n- 分析内容从创作者视角出发，提供可执行建议\n- **禁止自动查询**：未订阅且未收到用户明确查询输入时，禁止自动调用脚本或输出任何热榜信息\n\nFile v1.0.2:_skillhub_meta.json\n\n{\n  \"name\": \"xhs-daily-ranking\",\n  \"installedAt\": 1777449681027,\n  \"source\": \"import\"\n}\n\nArchive v1.0.1: 7 files, 42582 bytes\n\nFiles: _skillhub_meta.json (87b), references/core_workflow.md (25138b), scripts/gen_xhs_html.py (30466b), scripts/xhs_daily_fetcher.py (26331b), scripts/xhs_weekly.html (37151b), SKILL.md (13031b), _meta.json (136b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: xhs-daily-ranking\ndescription: 获取小红书平台单日爆发榜单数据，支持按分类查询当日热门笔记；当用户需要查询小红书当日热门内容、分析单日爆款笔记、了解各领域当日趋势或获取创作灵感时使用\n---\n\n# 小红书单日爆发榜\n\n---\n\n## 简介\n\n小红书单日爆发榜是一款专为内容创作者和营销人员设计的智能工具，帮助用户实时追踪小红书平台当日的爆款笔记数据。\n\n通过简单的关键词查询，你可以：\n\n- 🔥 获取每日单日爆发榜TOP50，解决「不知道今天什么内容在爆」的痛点\n- 📊 自动分析爆款特征和规律，解决「找爆文、拆规律效率低」的痛点\n- 📁 生成可视化HTML页面，一键导出分享，大幅降低内容分析成本\n- 🔔 支持每日固定时间订阅推送，不用手动重复查询\n\n适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。\n\n**技术基础**：基于小红书公开内容接口，每日19:00更新昨日榜单数据。\n\n---\n\n## 功能特性\n\n### 🎯 核心功能\n\n- **🔥 单日爆发榜查询**：获取当日热门笔记TOP50，按分类查询，支持25个垂直领域精准匹配\n- **📊 智能规律分析**：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告\n- **📈 多维度数据展示**：完整呈现互动数、点赞、评论、收藏、分享及新增数据\n- **🔔 自动订阅推送**：支持每日19:30固定时间推送最新榜单到消息栏\n\n### ✨ 特色亮点\n\n- **⏰ 智能日期适配**：支持指定日期或模糊日期查询，自动按规则匹配近2天数据\n- **📤 多格式输出**：自动生成Markdown表格+HTML可视化文件，支持导出PDF/图片\n- **🔗 一键跳转**：笔记和作者主页可直接点击跳转，查看原内容更便捷\n- **⚡ 无额外门槛**：无需小红书账号、无需API密钥，安装依赖即可使用\n\n---\n\n## 一键安装\n\n### 前置条件\n\n- 已安装 Python 3.8 及以上版本\n- 网络可正常访问小红书公开数据接口\n\n### 安装方式\n\n```bash\n# 进入项目目录\ncd ~/.workbuddy/skills/xhs-daily-ranking\n\n# 安装依赖\npip install requests\n\n# 验证脚本可执行\npython scripts/xhs_daily_fetcher.py --help\n```\n\n### 环境变量配置\n\n| 变量名               | 必填 | 说明                                                                    |\n| -------------------- | ---- | ----------------------------------------------------------------------- |\n| `XHS_API_PROXY`      | 否   | 代理服务器地址，若网络访问受限可配置，格式示例：`http://127.0.0.1:7890` |\n| `OUTPUT_PATH`        | 否   | 生成的榜单文件（.md/.html）保存路径，默认值为当前脚本运行目录           |\n| `DEFAULT_TOP_N`      | 否   | 默认查询的爆文数量，默认值为50，支持配置10-50范围内的整数               |\n| `SCHEDULE_PUSH_HOUR` | 否   | 订阅服务的每日推送时间（24小时制），默认值为19，即每日19:30推送         |\n\n---\n\n## 使用指南\n\n### 基础使用（3步）\n\n#### 1. 发起查询\n\n告诉工具你要查询的分类或关键词（未指定日期则自动按规则匹配近2天数据）：\n\n> 用户：帮我查一下睫毛膏相关的爆款笔记\n>\n> 助手：正在为你查询化妆美容分类的单日爆发榜数据...\n\n#### 2. 查看完整输出\n\n系统自动输出4项内容（完整流程规范见 [references/core_workflow.md](references/core_workflow.md)）：\n\n| 序号 | 输出内容            | 说明                                         |\n| ---- | ------------------- | -------------------------------------------- |\n| 1    | 🔥 单日爆发榜       | 含更新时间，展示TOP20数据                    |\n| 2    | 📊 单日爆发笔记分析 | 热门内容分析、爆款标题分析、最高数据作品分析 |\n| 3    | 📁 HTML页面         | 直接输出可视化页面，支持导出PDF/图片         |\n| 4    | 🔔 订阅服务         | 每日19:30推送选项                            |\n\n#### 3. 查看更多数据\n\n默认输出TOP20内容，输入「查看更多」即可获取全部50条内容：\n\n> 用户：查看更多\n>\n> 助手：为你展示全部50条单日爆发笔记...\n\n---\n\n### 高级使用（4步）\n\n#### 1. 分类匹配规则\n\n根据用户输入自动匹配合适的分类：\n\n**可用分类列表（共25个）**：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n\n**关键词-分类映射示例**：\n\n```\n睫毛膏/口红/粉底 → 化妆美容\n穿搭/衣服/时尚 → 时尚穿搭\n美食/做饭/探店 → 美味佳肴\n猫/狗/宠物 → 宠物天地\n游戏/王者/电竞 → 休闲爱好\n```\n\n#### 2. 日期判断规则\n\n- 用户指定了日期 → 直接使用指定日期\n- 用户未指定日期：\n  - 当前时间 >= 19:00 → 查询**昨日**数据\n  - 当前时间 < 19:00 → 查询**前天**数据\n\n#### 3. 数据输出逻辑\n\n| 阶段     | 单日爆发榜 | HTML页面          | 提示                          |\n| -------- | ---------- | ----------------- | ----------------------------- |\n| 首次输出 | TOP1-20    | TOP1-20           | 数据>20条时显示\"查看更多\"提示 |\n| 查看更多 | TOP21-末尾 | TOP1-末尾（完整） | -                             |\n\n#### 4. 数据一致性保障\n\n- 单日爆发榜表格与HTML页面必须使用相同数据源\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\n\n---\n\n### 命令速查表\n\n| 命令                   | 功能                        | 示例                     |\n| ---------------------- | --------------------------- | ------------------------ |\n| `查[关键词]爆款`       | 查询指定分类的单日爆发榜    | 查睫毛膏爆款             |\n| `查[日期][关键词]爆款` | 查询指定日期/分类的爆文榜单 | 查2026-04-20化妆美容爆款 |\n| `查看更多`             | 获取完整50条榜单数据        | 查看更多                 |\n| `订阅`                 | 开通每日爆款推送            | 订阅                     |\n| `取消订阅`             | 关闭每日推送服务            | 取消订阅                 |\n\n---\n\n## 使用场景\n\n| 场景            | 角色               | 需求                                           | 使用方式                                                           | 预期收益                                   |\n| --------------- | ------------------ | ---------------------------------------------- | ------------------------------------------------------------------ | ------------------------------------------ |\n| 找对标内容      | 0粉新手美妆博主    | 不知道小账号做什么内容能爆，头部博主参考性太低 | 每天查询美妆类单日爆发榜，拆解标题/内容/封面，模仿同款内容做差异化 | 最快1周找到爆文模版，起号速度提升3倍       |\n| 品牌运营跟热点  | 快消品牌小红书运营 | 跟进平台最新热点，做符合用户喜好的营销内容     | 订阅每日推送，提取热门关键词和内容形式融入品牌推广                 | 内容点击率提升40%，推广成本降低25%         |\n| MCN挖掘潜力新人 | MCN内容星探        | 挖掘还没火的潜力博主，降低签约成本             | 每天查看全分类单日爆发榜，筛选高互动新账号重点关注                 | 新人签约成本降低60%，账号孵化成功率提升50% |\n| 内容策划找灵感  | 内容策划/文案编辑  | 快速了解平台近期热门内容方向，为选题提供参考   | 按分类查询当日爆发榜，分析爆款共性特征总结模版                     | 选题效率提升2倍，内容产出质量更稳定        |\n\n---\n\n## 项目架构\n\n### 目录结构\n\n```\nxhs-daily-ranking/\n├── scripts/\n│   ├── xhs_daily_fetcher.py   # 数据拉取、榜单生成核心脚本\n│   └── gen_xhs_html.py        # HTML可视化文件生成脚本\n├── references/\n│   └── core_workflow.md       # 完整功能流程规范（核心）\n├── requirements.txt           # 依赖声明\n└── SKILL.md                  # Skill定义文档\n```\n\n### 技术栈\n\n- **运行环境**：Python 3.8+\n- **依赖库**：requests>=2.28.0\n- **输出格式**：Markdown / HTML\n- **数据来源**：小红书公开内容接口\n\n### 数据流转\n\n```\n用户请求 → 参数校验（日期/分类匹配） → 调用公开接口拉取数据\n    ↓\n生成Markdown榜单 → 规律分析 → 渲染HTML文件\n    ↓\n返回4项结果（榜单 + 分析 + HTML + 订阅选项）→ 用户响应\n```\n\n---\n\n## 常见问答\n\n### 安装相关问题\n\n**Q1: 安装时提示依赖缺失怎么办？**\n\nA: 请确保已安装 requests 库：\n\n```bash\npip install requests\n```\n\n**Q2: 支持哪些平台部署？**\n\nA: 目前支持以下平台：\n\n- Coze（字节跳动）- 推荐，功能最全\n- Dify - 适合企业级应用\n- 百度千帆 - 适合国内用户\n- 阿里云百炼 - 适合阿里云生态用户\n\n---\n\n### 使用相关问题\n\n**Q3: 数据多久更新一次？**\n\nA: 榜单每日19:00更新昨日数据。订阅推送时间为每日19:30。\n\n**Q4: 为什么有时候看不到当天的数据？**\n\nA: 由于数据更新机制，当日19:00前只能查到前天数据。19:00后才能查到昨日数据。\n\n**Q5: 为什么分享数据有时候不显示？**\n\nA: 分享字段使用 `AnaAddBean.useShareCount`（累计分享数）和 `AnaAddBean.addShareCount`（新增分享数）。如数据缺失请检查API返回字段。\n\n---\n\n### 故障排除\n\n**Q6: 数据不更新怎么办？**\n\nA: 请按以下步骤排查：\n\n1. 检查网络连接是否正常\n2. 确认当前时间是否 >= 19:00（数据更新时间）\n3. 尝试手动触发更新：发送命令重新查询\n4. 检查API接口是否可用\n\n**Q7: HTML页面打不开或显示异常？**\n\nA: 请确保：\n\n1. 浏览器支持HTML5\n2. 网络可正常加载页面资源\n3. 如导出PDF异常，请检查浏览器打印功能是否正常\n\n---\n\n### 安全许可\n\n**Q8: 使用这个Skill有封号风险吗？**\n\nA: 本Skill基于小红书公开内容接口，无需登录账号，无封禁风险。但请勿高频大量请求，以免触发平台限流。\n\n---\n\n## ⚠️ 输出规范（重要）\n\n> 完整功能流程规范见 [references/core_workflow.md](references/core_workflow.md)\n\n### 触发前提（强制，禁止违反）\n\n- **禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息**\n- 只有当用户主动输入关键词、分类名或明确表达查询意图时，才可调用脚本获取数据\n- **禁止主动向用户推送热榜数据、禁止在闲聊或无关对话中自动调用接口**\n\n### 四项输出内容（强制执行）\n\n| 序号 | 输出内容            | 要求                           |\n| ---- | ------------------- | ------------------------------ |\n| 1    | 🔥 单日爆发榜       | 含更新时间，禁止折叠，禁止遗漏 |\n| 2    | 📊 单日爆发笔记分析 | 3个模块，禁止折叠，禁止遗漏    |\n| 3    | 📁 HTML页面         | 直接输出页面，禁止只输出路径   |\n| 4    | 🔔 订阅服务         | HTML页面后立即输出，禁止跳过   |\n\n### 输出格式要求（强制执行）\n\n- **禁止折叠输出**：所有内容必须直接完整输出\n- **禁止输出文件**：除HTML页面外，禁止输出任何其他文件\n- **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务\n\n### 执行脚本命令\n\n```bash\n# 获取榜单数据（最多50条）\npython scripts/xhs_daily_fetcher.py --keyword \"{关键词}\" --top_n 50\n\n# 生成HTML页面\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20   # 首次输出\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50   # 查看更多\n```\n\n---\n\n## 资源索引\n\n| 资源         | 路径                           | 说明                             |\n| ------------ | ------------------------------ | -------------------------------- |\n| 完整流程规范 | `references/core_workflow.md`  | 详细输出规范、操作步骤、使用示例 |\n| 数据获取脚本 | `scripts/xhs_daily_fetcher.py` | 获取小红书爆款内容榜单数据       |\n| HTML生成脚本 | `scripts/gen_xhs_html.py`      | 生成可视化HTML页面               |\n\n---\n\n### 订阅服务内容（必须原样输出，禁止修改，禁止省略）\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"xhs-daily-ranking\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1777462766390\n}\n\nFile v1.0.1:references/core_workflow.md\n\n# 小红书单日爆发榜\n\n## 任务目标\n\n- 本 Skill 用于：获取小红书平台爆款内容榜单数据\n- 能力包含：\n  - 单日爆发榜数据获取（按分类查询）\n  - 单日热门笔记智能分析\n  - 冷门爆款笔记挖掘（关键词匹配分类）\n  - 订阅服务（每日定时推送）\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\n\n## 数据接口更新规则\n\n- **更新时间**：每天19:00更新昨天的榜单数据\n- **数据范围**：当日的热门笔记TOP50\n- **分类覆盖**：25个垂直领域分类\n\n## 输出规范（强制执行）\n\n**触发前提（强制，禁止违反）**：\n\n- **禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息**\n- 只有当用户主动输入关键词、分类名或明确表达查询意图时，才可调用脚本获取数据\n- 仅订阅推送场景下，按订阅约定时间自动输出，其余场景一律等待用户主动触发\n- **禁止主动向用户推送热榜数据、禁止在闲聊或无关对话中自动调用接口**\n\n**数据一致性要求（重要）**：\n\n- 单日爆发榜表格与HTML页面数据必须完全一致（相同顺序、相同内容）\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\n- 禁止胡乱渲染或使用不同数据源\n\n**输出内容必须严格包含以下四部分，禁止遗漏或胡乱输出：**\n\n- **单日爆发榜（更新时间）**：必须直接输出，禁止折叠，禁止遗漏\n- **单日爆发笔记分析**：必须直接输出，禁止折叠，禁止遗漏\n- **HTML页面**：必须生成并输出，禁止折叠，禁止遗漏\n- **订阅服务**：必须在HTML页面之后强制输出，禁止跳过，禁止遗漏，禁止等待用户回复\n\n**输出格式要求（强制执行）**：\n\n- **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n- **禁止输出文件**：除HTML页面外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n- **HTML必须直接输出页面，禁止只输出文件路径**\n- **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务的顺序执行，禁止混乱输出\n\n### 第一部分：单日爆发榜（必须包含榜单的数据更新时间）\n\n**输出要求**：\n\n- 必须直接完整输出表格内容\n- 禁止折叠、隐藏或展开表格\n- 禁止输出为文件格式\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\n\n- 标题格式：**🔥 【{分类名称}】单日爆发榜 （更新时间：{查询日期} 19:00）**（标题整体加粗）\n- 标题示例：**🔥 【化妆美容】单日爆发榜 （更新时间：2026-04-21 19:00）**\n\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\n\n| 排名 | 笔记信息                                         |      互动数       |       点赞        |       评论       |       收藏       |       分享        |\n| :--: | :----------------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\n|  🥇  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 22w+<br>↑新增23w+ | 22w+<br>↑新增21w+ | 893<br>↑新增21w+ | 1w+<br>↑新增21w+ | 1w+<br>↑新增21w+  |\n|  🥈  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 20w+<br>↑新增18w+ | 18w+<br>↑新增16w+ | 756<br>↑新增18w+ | 8k+<br>↑新增16w+ | 900+<br>↑新增16w+ |\n|  🥉  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 18w+<br>↑新增15w+ | 15w+<br>↑新增13w+ | 621<br>↑新增15w+ | 7k+<br>↑新增13w+ | 800+<br>↑新增13w+ |\n\n**字段详细说明**：\n\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\n- **笔记信息**：\n  - 第一行：笔记标题（可点击跳转）\n  - 第二行：[作者名](作者主页链接) 粉丝数+（作者名可点击跳转到作者主页，链接使用API返回的userJumpUrl字段，字号与标题一样大）\n- **互动数**：\n  - 第一行：累计互动数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **点赞**：\n  - 第一行：累计点赞数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **评论**：\n  - 第一行：累计评论数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **收藏**：\n  - 第一行：累计收藏数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **分享**：\n  - 第一行：累计分享数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n  - **分享字段必须展示且不能出错**\n\n**重要说明**：\n\n- 使用标准 Markdown 表格格式\n- 单元格内使用 `<br>` 换行显示累计数据和新增数据\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\n- 新增数据格式：累计数据 <br> ↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\n- \"↑新增\"文案字号比累计数据小一号\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\n\n**数据说明（必须在表格上方、标题之后输出）**：\n\n- 在单日爆发榜标题之后、表格之前输出：_单日爆发榜指笔记发后第3天比第2天涨的数据由高到低Top50_\n\n**数据输出逻辑（必须严格执行）**：\n\n- **首次输出**：\n  - 单日爆发榜表格：显示TOP1到TOP20\n  - HTML页面：显示TOP1到TOP20（与热榜表格保持一致）\n  - **\"查看更多\"提示逻辑**（必须严格执行）：\n    - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\n    - 如果返回数据 > 20条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"（显示剩余数据条数）\n    - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\n- **用户输入\"查看更多\"后**：\n  - 单日爆发榜表格：输出TOP21到实际数据末尾（延续之前的TOP20）\n  - HTML页面：输出TOP1到实际数据末尾（完整数据，覆盖之前的HTML文件）\n\n### 第二部分：单日爆发笔记分析\n\n**输出要求**：\n\n- 必须直接完整输出3个模块内容（热门内容分析、爆款标题分析、最高数据作品分析）\n- 禁止折叠、隐藏或展开任何模块\n- 禁止输出为文件格式\n- 所有分析内容都基于获取到的所有数据\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\n- **必须包含3个模块，禁止遗漏**\n\n- 标题格式：**📊 单日爆发笔记分析**（加粗，不带Top数量）\n- 示例：**📊 单日爆发笔记分析**\n\n以下内容分析基于获取的全部数据（共{数据条数}条）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征                                                                                                                                                                           | 实际效果      | 参考笔记                           |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]<br>[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望                           | 互动率提升50% | [笔记标题链接3]<br>[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查                         | 收藏率提升55% | [笔记标题链接5]<br>[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力                                     | 曝光率提升40% | [笔记标题链接7]<br>[笔记标题链接8] |\n\n**📈爆款标题分析**\n\n| 标题类型 | 标题特征                                                                                                           | 标题模版         | 发布规律             | 参考标题                 |\n| :------- | :----------------------------------------------------------------------------------------------------------------- | :--------------- | :------------------- | :----------------------- |\n| 提问式   | 标题以疑问句开头，设置悬念或提出用户关心的问题，引发用户的好奇心和思考欲望，激发点击阅读或评论互动                 | \"你还在XX吗？\"   | 工作日早高峰效果最佳 | 这个方法你还在用吗？     |\n| 数字式   | 标题中包含具体的数字、数量或统计数据，利用人们对量化信息的偏好，增强内容的可信度和专业感，让用户觉得内容有价值     | \"XX个XX技巧\"     | 午餐时间点击率高     | 5个快速提升XX的技巧      |\n| 情绪词   | 使用具有强烈情感色彩的词汇或网络流行语，如\"绝了\"、\"太XX了\"等，直接触发用户的情绪反应，引发点赞、评论或分享行为     | \"太XX了！忍不住\" | 晚间黄金时段转化高   | 太好用了！忍不住分享给你 |\n| 利益点   | 直接在标题中明确承诺用户可以获得的具体利益或效果，如\"XX天就能XX\"、\"省XX元\"等，降低用户决策成本，提高点击率和收藏率 | \"XX天就能XX\"     | 深夜发布收藏率最高   | 7天就能看到明显效果      |\n\n**✨最高数据作品分析**\n\n| 维度     | 核心特征分析                                               | 参考笔记       |\n| :------- | :--------------------------------------------------------- | :------------- |\n| 最高点赞 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n\n### 第三部分：HTML页面\n\n**强制要求（必须严格遵守）**：\n\n- HTML页面是4项输出中的第3项，必须在单日爆发榜和单日分析之后输出\n- 不需要等待用户回复，单日分析输出后立即执行\n- **禁止只输出文件路径，必须直接输出HTML页面**\n- **禁止折叠输出**\n- 这是唯一允许输出的文件，其他内容禁止输出为文件\n\n**执行命令**：\n\n- **首次输出**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\n- **用户输入\"查看更多\"后**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50`\n\n**文件特点**：\n\n- 可独立打开的HTML文件\n- 支持直接点击链接跳转\n- 支持导出图片和PDF功能（导出结果与页面显示完全一致，PDF和图片导出内容一定是正确的）\n- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为\"↑新增数值\"格式，整体字号增大1px\n- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据，分享字段必须展示且不能出错）\n\n## 数据输出逻辑详解\n\n**核心原则**：\n\n- 单日爆发榜表格与HTML页面必须保持数据一致性\n- 使用相同的API接口，禁止修改接口返回的顺序\n\n### 阶段一：首次输出\n\n1. **单日爆发榜表格**：\n   - 调用脚本获取数据（最多50条）\n   - 展示TOP1到TOP20（前20条）\n   - **\"查看更多\"提示逻辑（根据实际数据量动态调整）**：\n     - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\n     - 如果返回数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{实际剩余数量}条！✨\"\n     - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\n\n2. **HTML页面**：\n   - 执行命令：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\n   - 生成HTML文件，包含TOP1到TOP20数据\n   - 与单日爆发榜表格数据完全一致\n\n### 阶段二：用户输入\"查看更多\"\n\n1. **单日爆发榜表格**：\n   - 继续展示TOP21到实际数据末尾（根据实际数据量）\n   - 延续首次输出的数据，不重复TOP1-20\n\n### 第四部分：订阅服务（紧接HTML页面之后输出，禁止跳过）\n\n**强制要求（必须严格遵守）**：\n\n- 必须在HTML页面输出完成后展示\n- 提供每日19:30推送小红书单日热门笔记TOP50的订阅选项\n- 用户可回复数字或\"取消\"\n- **禁止遗漏，禁止胡乱输出**\n\n**订阅服务内容（必须原样输出，禁止修改，禁止省略）**：\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\n**订阅逻辑**：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n\n**输出顺序（严格按此顺序执行，禁止混乱输出，禁止遗漏）**：\n\n1. 🔥 单日爆发榜（含更新时间）\n2. 📊 单日爆发笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n3. 📁 HTML页面（直接输出，禁止只输出路径）\n4. 订阅服务（推送选项）\n\n**重要提示（强制，禁止违反）**：\n\n- **必须严格包含以上4项内容，禁止遗漏**\n  - 🔥 单日爆发榜（含更新时间）\n  - 📊 单日爆发笔记分析（3个模块）\n  - 📁 HTML页面（直接输出页面，输出后继续执行订阅服务）\n  - **订阅服务（推送选项，必须在HTML页面之后立即输出，禁止跳过，禁止遗漏）**\n- **禁止胡乱输出，禁止输出其他内容**\n- **禁止输出顺序混乱，必须严格按照上述顺序**\n- **订阅服务必须强制执行，HTML页面输出完成后必须立即展示订阅服务，不能等待用户回复，不能跳过，不能遗漏**\n\n### 数据一致性保障\n\n- 两个脚本使用相同的API接口\n- 相同的API接口，禁止修改接口返回的顺序\n- 相同的数据字段和格式\n- 确保表格和HTML页面的排名、数据完全一致（禁止修改接口返回的顺序）\n\n## 操作步骤\n\n### 标准流程\n\n#### 第一步：分类匹配\n\n根据用户输入自动匹配合适的分类：\n\n**可用分类列表（共25个）**：\n综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n\n**匹配规则**：\n\n- 用户输入具体产品词（如\"睫毛膏\"）→ 匹配对应分类（\"化妆美容\"）\n- 用户输入领域词（如\"穿搭\"、\"美食\"）→ 直接匹配分类\n- 未指定分类 → 使用\"综合全部\"\n\n**关键词-分类映射示例**：\n\n```\n睫毛膏/口红/粉底 → 化妆美容\n穿搭/衣服/时尚 → 时尚穿搭\n美食/做饭/探店 → 美味佳肴\n猫/狗/宠物 → 宠物天地\n游戏/王者/电竞 → 休闲娱乐\n```\n\n#### 第二步：查询冷门爆款笔记\n\n- 用户输入关键词后，自动匹配对应分类（**不告知用户匹配到的分类名称**）\n- 查询该分类下的冷门爆款笔记（最多50条）\n- **根据实际数据量动态展示**：\n  - 如果返回数据 ≤ 20条：默认展示全部数据，不展示\"查看更多\"提示\n  - 如果返回数据 > 20条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余{数量}条！✨\"提示\n  - 如果返回数据 = 50条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余30条！✨\"提示\n\n#### 第三步：日期判断\n\n根据用户输入和当前时间确定查询日期：\n\n**判断规则**：\n\n1. **用户指定了日期** → 直接使用指定日期\n2. **用户未指定日期**：\n   - 当前时间 >= 19:00 → 查询**昨日**数据（当日19:00已更新）\n   - 当前时间 < 19:00 → 查询**前天**数据（等待当日19:00更新）\n\n#### 第四步：获取单日爆发榜数据\n\n调用脚本获取榜单数据：\n\n```bash\npython scripts/xhs_daily_fetcher.py --keyword \"睫毛膏\" --top_n 50\n```\n\n**参数说明**：\n\n- `--category`：分类名称（可选）\n- `--keyword`：用户输入的关键词，用于自动匹配分类\n- `--rank_date`：查询日期（可选，自动判断）\n- `--top_n`：返回条数（默认50）\n\n**数据完整性要求**：\n\n- 确保表格所有字段和数据完整加载\n- 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\n- 直到所有字段（排名、笔记信息、互动数、点赞、评论、收藏、分享）都有完整数据\n- **分享字段使用正确的API字段名**：`AnaAddBean.useShareCount`（累计分享数）、`AnaAddBean.addShareCount`（新增分享数）\n- **确保分享数值正确输出，避免使用错误的字段名导致数值不对**\n\n#### 第五步：输出单日爆发榜和单日分析\n\n按照输出规范，依次输出：\n\n1. 单日爆发榜（含更新时间）\n2. 单日爆发笔记分析（3个模块）\n\n#### 第六步：生成HTML页面（4项输出中的第3项）\n\n**重要要求：HTML页面输出完成后必须继续执行第七步（订阅服务），HTML不是最后一步**\n\n生成可视化HTML页面：\n\n**首次输出时**：\n\n```bash\npython scripts/gen_xhs_html.py --keyword \"穿搭\" --top 20\n```\n\n**用户输入\"查看更多\"后**：\n\n```bash\npython scripts/gen_xhs_html.py --keyword \"穿搭\" --top 50\n```\n\n**输出格式（直接输出HTML页面，禁止只输出文件路径）**：\n\n#### 第七步：输出订阅服务（强制，禁止跳过，禁止遗漏）\n\n**必须在HTML页面输出完成后立即执行此步，不能等待用户回复，不能跳过，不能遗漏**\n\n直接输出以下内容（禁止修改，禁止省略）：\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\n**订阅逻辑**：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n\n## 订阅服务说明\n\n### 订阅内容\n\n**小红书单日爆发笔记推荐TOP50**\n\n- 每日19:30更新\n- 推送当日的50篇热门内容\n- 包含完整分析和HTML文件\n\n### 订阅输出格式\n\n按上述4项输出顺序执行即可，与标准输出格式一致。\n\n## 使用示例\n\n### 示例1：关键词查询\n\n- **场景/输入**：\"帮我查一下睫毛膏相关的爆款笔记\"\n- **预期产出**：匹配化妆美容分类，依次输出单日爆发榜、单日分析、HTML页面、订阅服务\n\n### 示例2：泛查询热门内容\n\n- **场景/输入**：\"最近小红书有什么热门内容\"\n- **预期产出**：使用综合全部分类，依次输出4项内容\n\n## 资源索引\n\n- **脚本**：见 [scripts/xhs_daily_fetcher.py](scripts/xhs_daily_fetcher.py)\n  - 用途：获取小红书爆款内容榜单数据\n  - 参数：--category 分类名 / --keyword 关键词 / --top_n 条数\n- **脚本**：见 [scripts/gen_xhs_html.py](scripts/gen_xhs_html.py)\n  - 用途：生成可视化HTML页面\n  - 参数：--category 分类名 / --top 条数 / --output 输出路径\n\n## 注意事项\n\n- 数据每日19:00更新昨天的榜单\n- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含单日爆发榜（更新时间）+ 单日爆发笔记分析 + HTML页面 + 订阅服务\n  - 🔥 单日爆发榜（必须包含更新时间）\n  - 📊 单日爆发笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n  - 📁 HTML页面（直接输出HTML页面，禁止只输出文件路径）\n  - **订阅服务（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复）**：🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n  - **禁止输出遗漏，禁止胡乱输出，必须严格按照此4项内容输出，订阅服务与其他3项同等强制**\n- **输出格式要求（强制）**：\n  - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n  - **禁止输出文件**：除HTML页面外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n  - **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务的顺序执行，禁止混乱输出\n- **输出顺序（严格按此顺序执行，禁止混乱输出）**：\n  1. **🔥 单日爆发榜**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）\n  2. **📊 单日爆发笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）\n  3. **📁 HTML页面**（4项输出中的第3项，直接输出HTML页面禁止只输出路径，输出后继续执行订阅服务）\n  4. **订阅服务（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复，与前三项同等强制）**：HTML页面输出完成后立即原样输出订阅服务文案\n- **HTML页面输出要求（强制）**：\n  - 是4项输出中的第3项，直接输出HTML页面，禁止只输出文件路径\n  - **禁止只输出文件路径，必须直接输出HTML页面**\n  - **禁止折叠输出**\n  - **PDF和图片导出内容一定是正确的**\n  - 不需要等待任何流程\n- **订阅服务输出要求（强制，禁止遗漏）**：\n  - 订阅服务是4项输出内容之一，与其他3项同等强制，禁止遗漏\n  - 必须在HTML页面输出完成后立即展示，不能等待用户回复\n  - **禁止跳过，禁止遗漏，禁止等待用户回复，禁止折叠**\n  - 提供订阅选项：每日19:30推送小红书单日爆发笔记TOP50 或 暂不需要-仅本次查询\n  - 订阅逻辑：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n  - 请用户回复数字或\"取消\"\n- **数据一致性要求**：单日爆发榜表格与HTML页面必须使用相同的数据源，禁止修改接口返回的顺序，确保完全一致\n- **数据完整性要求（强制）**：\n  - 表格所有字段和数据必须完整加载\n  - 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\n  - 直到所有字段都有完整数据（单日爆发榜7个字段、单日分析所有表格字段）\n- **数据输出逻辑（必须严格执行）**：\n  - 首次输出：单日爆发榜TOP1-20，HTML页面TOP1-20（保持一致）\n  - 查看更多：单日爆发榜TOP21-实际数据末尾，HTML页面TOP1-实际数据末尾（完整数据）\n  - **\"查看更多\"提示逻辑**：\n    - 数据 ≤ 20条：不展示\n    - 数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"\n    - 数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"\n- 表格字段：排名、笔记信息、互动数（新增互动）、点赞（新增点赞）、评论（新增评论）、收藏（新增收藏）、分享（新增分享，**必须展示且不能出错，避免胡乱输出**）\n- 单日分析包含：热门内容分析、爆款标题分析、最高数据作品分析\n- 单日分析标题后显示\"以下内容分析基于获取的全部数据（共{数据条数}条）进行~\"\n- 分析内容从创作者视角出发，提供可执行建议\n- **禁止自动查询**：未订阅且未收到用户明确查询输入时，禁止自动调用脚本或输出任何热榜信息\n\nFile v1.0.1:_skillhub_meta.json\n\n{\n  \"name\": \"xhs-daily-ranking\",\n  \"installedAt\": 1777449681027,\n  \"source\": \"import\"\n}\n\nArchive v1.0.0: 7 files, 42443 bytes\n\nFiles: _skillhub_meta.json (87b), assets/core_workflow.md (25138b), scripts/gen_xhs_html.py (30594b), scripts/xhs_daily_fetcher.py (26779b), scripts/xhs_weekly.html (37151b), SKILL.md (11622b), _meta.json (136b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: xhs-daily-ranking\ndescription: 获取小红书平台单日爆发榜单数据，支持按分类查询当日热门笔记；当用户需要查询小红书当日热门内容、分析单日爆款笔记、了解各领域当日趋势或获取创作灵感时使用\n---\n\n# 小红书单日爆发榜\n\n---\n\n## 简介\n\n小红书单日爆发榜是一款专为内容创作者和营销人员设计的智能工具，帮助用户实时追踪小红书平台当日的爆款笔记数据。\n\n通过简单的关键词查询，你可以：\n- 🔥 获取每日单日爆发榜TOP50，解决「不知道今天什么内容在爆」的痛点\n- 📊 自动分析爆款特征和规律，解决「找爆文、拆规律效率低」的痛点\n- 📁 生成可视化HTML页面，一键导出分享，大幅降低内容分析成本\n- 🔔 支持每日固定时间订阅推送，不用手动重复查询\n\n适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。\n\n**技术基础**：基于小红书公开内容接口，每日19:00更新昨日榜单数据。\n\n---\n\n## 功能特性\n\n### 🎯 核心功能\n\n- **🔥 单日爆发榜查询**：获取当日热门笔记TOP50，按分类查询，支持25个垂直领域精准匹配\n- **📊 智能规律分析**：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告\n- **📈 多维度数据展示**：完整呈现互动数、点赞、评论、收藏、分享及新增数据\n- **🔔 自动订阅推送**：支持每日19:30固定时间推送最新榜单到消息栏\n\n### ✨ 特色亮点\n\n- **⏰ 智能日期适配**：支持指定日期或模糊日期查询，自动按规则匹配近2天数据\n- **📤 多格式输出**：自动生成Markdown表格+HTML可视化文件，支持导出PDF/图片\n- **🔗 一键跳转**：笔记和作者主页可直接点击跳转，查看原内容更便捷\n- **⚡ 无额外门槛**：无需小红书账号、无需API密钥，安装依赖即可使用\n\n---\n\n## 一键安装\n\n### 前置条件\n\n- 已安装 Python 3.8 及以上版本\n- 网络可正常访问小红书公开数据接口\n\n### 安装方式\n\n```bash\n# 进入项目目录\ncd ~/.workbuddy/skills/xhs-daily-ranking\n\n# 安装依赖\npip install requests\n\n# 验证脚本可执行\npython scripts/xhs_daily_fetcher.py --help\n```\n\n### 环境变量配置\n\n| 变量名 | 必填 | 说明 |\n| --- | --- | --- |\n| `XHS_API_PROXY` | 否 | 代理服务器地址，若网络访问受限可配置，格式示例：`http://127.0.0.1:7890` |\n| `OUTPUT_PATH` | 否 | 生成的榜单文件（.md/.html）保存路径，默认值为当前脚本运行目录 |\n| `DEFAULT_TOP_N` | 否 | 默认查询的爆文数量，默认值为50，支持配置10-50范围内的整数 |\n| `SCHEDULE_PUSH_HOUR` | 否 | 订阅服务的每日推送时间（24小时制），默认值为19，即每日19:30推送 |\n\n---\n\n## 使用指南\n\n### 基础使用（3步）\n\n#### 1. 发起查询\n\n告诉工具你要查询的分类或关键词（未指定日期则自动按规则匹配近2天数据）：\n\n> 用户：帮我查一下睫毛膏相关的爆款笔记\n>\n> 助手：正在为你查询化妆美容分类的单日爆发榜数据...\n\n#### 2. 查看完整输出\n\n系统自动输出4项内容（完整流程规范见 [assets/core_workflow.md](assets/core_workflow.md)）：\n\n| 序号 | 输出内容 | 说明 |\n| --- | --- | --- |\n| 1 | 🔥 单日爆发榜 | 含更新时间，展示TOP20数据 |\n| 2 | 📊 单日爆发笔记分析 | 热门内容分析、爆款标题分析、最高数据作品分析 |\n| 3 | 📁 HTML页面 | 直接输出可视化页面，支持导出PDF/图片 |\n| 4 | 🔔 订阅服务 | 每日19:30推送选项 |\n\n#### 3. 查看更多数据\n\n默认输出TOP20内容，输入「查看更多」即可获取全部50条内容：\n\n> 用户：查看更多\n>\n> 助手：为你展示全部50条单日爆发笔记...\n\n---\n\n### 高级使用（4步）\n\n#### 1. 分类匹配规则\n\n根据用户输入自动匹配合适的分类：\n\n**可用分类列表（共25个）**：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n\n**关键词-分类映射示例**：\n```\n睫毛膏/口红/粉底 → 化妆美容\n穿搭/衣服/时尚 → 时尚穿搭\n美食/做饭/探店 → 美味佳肴\n猫/狗/宠物 → 宠物天地\n游戏/王者/电竞 → 休闲爱好\n```\n\n#### 2. 日期判断规则\n\n- 用户指定了日期 → 直接使用指定日期\n- 用户未指定日期：\n  - 当前时间 >= 19:00 → 查询**昨日**数据\n  - 当前时间 < 19:00 → 查询**前天**数据\n\n#### 3. 数据输出逻辑\n\n| 阶段 | 单日爆发榜 | HTML页面 | 提示 |\n| --- | --- | --- | --- |\n| 首次输出 | TOP1-20 | TOP1-20 | 数据>20条时显示\"查看更多\"提示 |\n| 查看更多 | TOP21-末尾 | TOP1-末尾（完整） | - |\n\n#### 4. 数据一致性保障\n\n- 单日爆发榜表格与HTML页面必须使用相同数据源\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\n\n---\n\n### 命令速查表\n\n| 命令 | 功能 | 示例 |\n| --- | --- | --- |\n| `查[关键词]爆款` | 查询指定分类的单日爆发榜 | 查睫毛膏爆款 |\n| `查[日期][关键词]爆款` | 查询指定日期/分类的爆文榜单 | 查2026-04-20化妆美容爆款 |\n| `查看更多` | 获取完整50条榜单数据 | 查看更多 |\n| `订阅` | 开通每日爆款推送 | 订阅 |\n| `取消订阅` | 关闭每日推送服务 | 取消订阅 |\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 需求 | 使用方式 | 预期收益 |\n| --- | --- | --- | --- | --- |\n| 找对标内容 | 0粉新手美妆博主 | 不知道小账号做什么内容能爆，头部博主参考性太低 | 每天查询美妆类单日爆发榜，拆解标题/内容/封面，模仿同款内容做差异化 | 最快1周找到爆文模版，起号速度提升3倍 |\n| 品牌运营跟热点 | 快消品牌小红书运营 | 跟进平台最新热点，做符合用户喜好的营销内容 | 订阅每日推送，提取热门关键词和内容形式融入品牌推广 | 内容点击率提升40%，推广成本降低25% |\n| MCN挖掘潜力新人 | MCN内容星探 | 挖掘还没火的潜力博主，降低签约成本 | 每天查看全分类单日爆发榜，筛选高互动新账号重点关注 | 新人签约成本降低60%，账号孵化成功率提升50% |\n| 内容策划找灵感 | 内容策划/文案编辑 | 快速了解平台近期热门内容方向，为选题提供参考 | 按分类查询当日爆发榜，分析爆款共性特征总结模版 | 选题效率提升2倍，内容产出质量更稳定 |\n\n---\n\n## 项目架构\n\n### 目录结构\n\n```\nxhs-daily-ranking/\n├── scripts/\n│   ├── xhs_daily_fetcher.py   # 数据拉取、榜单生成核心脚本\n│   └── gen_xhs_html.py        # HTML可视化文件生成脚本\n├── assets/\n│   └── core_workflow.md       # 完整功能流程规范（核心）\n├── references/\n│   └── api-spec.md            # 接口规范文档\n├── requirements.txt           # 依赖声明\n└── SKILL.md                  # Skill定义文档\n```\n\n### 技术栈\n\n- **运行环境**：Python 3.8+\n- **依赖库**：requests>=2.28.0\n- **输出格式**：Markdown / HTML\n- **数据来源**：小红书公开内容接口\n\n### 数据流转\n\n```\n用户请求 → 参数校验（日期/分类匹配） → 调用公开接口拉取数据\n    ↓\n生成Markdown榜单 → 规律分析 → 渲染HTML文件\n    ↓\n返回4项结果（榜单 + 分析 + HTML + 订阅选项）→ 用户响应\n```\n\n---\n\n## 常见问答\n\n### 安装相关问题\n\n**Q1: 安装时提示依赖缺失怎么办？**\n\nA: 请确保已安装 requests 库：\n```bash\npip install requests\n```\n\n**Q2: 支持哪些平台部署？**\n\nA: 目前支持以下平台：\n- Coze（字节跳动）- 推荐，功能最全\n- Dify - 适合企业级应用\n- 百度千帆 - 适合国内用户\n- 阿里云百炼 - 适合阿里云生态用户\n\n---\n\n### 使用相关问题\n\n**Q3: 数据多久更新一次？**\n\nA: 榜单每日19:00更新昨日数据。订阅推送时间为每日19:30。\n\n**Q4: 为什么有时候看不到当天的数据？**\n\nA: 由于数据更新机制，当日19:00前只能查到前天数据。19:00后才能查到昨日数据。\n\n**Q5: 为什么分享数据有时候不显示？**\n\nA: 分享字段使用 `AnaAddBean.useShareCount`（累计分享数）和 `AnaAddBean.addShareCount`（新增分享数）。如数据缺失请检查API返回字段。\n\n---\n\n### 故障排除\n\n**Q6: 数据不更新怎么办？**\n\nA: 请按以下步骤排查：\n1. 检查网络连接是否正常\n2. 确认当前时间是否 >= 19:00（数据更新时间）\n3. 尝试手动触发更新：发送命令重新查询\n4. 检查API接口是否可用\n\n**Q7: HTML页面打不开或显示异常？**\n\nA: 请确保：\n1. 浏览器支持HTML5\n2. 网络可正常加载页面资源\n3. 如导出PDF异常，请检查浏览器打印功能是否正常\n\n---\n\n### 安全许可\n\n**Q8: 使用这个Skill有封号风险吗？**\n\nA: 本Skill基于小红书公开内容接口，无需登录账号，无封禁风险。但请勿高频大量请求，以免触发平台限流。\n\n---\n\n## ⚠️ 输出规范（重要）\n\n> 完整功能流程规范见 [assets/core_workflow.md](assets/core_workflow.md)\n\n### 触发前提（强制，禁止违反）\n\n- **禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息**\n- 只有当用户主动输入关键词、分类名或明确表达查询意图时，才可调用脚本获取数据\n- **禁止主动向用户推送热榜数据、禁止在闲聊或无关对话中自动调用接口**\n\n### 四项输出内容（强制执行）\n\n| 序号 | 输出内容 | 要求 |\n| --- | --- | --- |\n| 1 | 🔥 单日爆发榜 | 含更新时间，禁止折叠，禁止遗漏 |\n| 2 | 📊 单日爆发笔记分析 | 3个模块，禁止折叠，禁止遗漏 |\n| 3 | 📁 HTML页面 | 直接输出页面，禁止只输出路径 |\n| 4 | 🔔 订阅服务 | HTML页面后立即输出，禁止跳过 |\n\n### 输出格式要求（强制执行）\n\n- **禁止折叠输出**：所有内容必须直接完整输出\n- **禁止输出文件**：除HTML页面外，禁止输出任何其他文件\n- **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务\n\n### 执行脚本命令\n\n```bash\n# 获取榜单数据（最多50条）\npython scripts/xhs_daily_fetcher.py --keyword \"{关键词}\" --top_n 50\n\n# 生成HTML页面\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20   # 首次输出\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50   # 查看更多\n```\n\n---\n\n## 资源索引\n\n| 资源 | 路径 | 说明 |\n| --- | --- | --- |\n| 完整流程规范 | `assets/core_workflow.md` | 详细输出规范、操作步骤、使用示例 |\n| 数据获取脚本 | `scripts/xhs_daily_fetcher.py` | 获取小红书爆款内容榜单数据 |\n| HTML生成脚本 | `scripts/gen_xhs_html.py` | 生成可视化HTML页面 |\n| 接口规范文档 | `references/api-spec.md` | API接口详细说明 |\n\n---\n\n### 订阅服务内容（必须原样输出，禁止修改，禁止省略）\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"xhs-daily-ranking\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1777454700817\n}\n\nFile v1.0.0:assets/core_workflow.md\n\n# 小红书单日爆发榜\n\n## 任务目标\n\n- 本 Skill 用于：获取小红书平台爆款内容榜单数据\n- 能力包含：\n  - 单日爆发榜数据获取（按分类查询）\n  - 单日热门笔记智能分析\n  - 冷门爆款笔记挖掘（关键词匹配分类）\n  - 订阅服务（每日定时推送）\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\n\n## 数据接口更新规则\n\n- **更新时间**：每天19:00更新昨天的榜单数据\n- **数据范围**：当日的热门笔记TOP50\n- **分类覆盖**：25个垂直领域分类\n\n## 输出规范（强制执行）\n\n**触发前提（强制，禁止违反）**：\n\n- **禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息**\n- 只有当用户主动输入关键词、分类名或明确表达查询意图时，才可调用脚本获取数据\n- 仅订阅推送场景下，按订阅约定时间自动输出，其余场景一律等待用户主动触发\n- **禁止主动向用户推送热榜数据、禁止在闲聊或无关对话中自动调用接口**\n\n**数据一致性要求（重要）**：\n\n- 单日爆发榜表格与HTML页面数据必须完全一致（相同顺序、相同内容）\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\n- 禁止胡乱渲染或使用不同数据源\n\n**输出内容必须严格包含以下四部分，禁止遗漏或胡乱输出：**\n\n- **单日爆发榜（更新时间）**：必须直接输出，禁止折叠，禁止遗漏\n- **单日爆发笔记分析**：必须直接输出，禁止折叠，禁止遗漏\n- **HTML页面**：必须生成并输出，禁止折叠，禁止遗漏\n- **订阅服务**：必须在HTML页面之后强制输出，禁止跳过，禁止遗漏，禁止等待用户回复\n\n**输出格式要求（强制执行）**：\n\n- **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n- **禁止输出文件**：除HTML页面外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n- **HTML必须直接输出页面，禁止只输出文件路径**\n- **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务的顺序执行，禁止混乱输出\n\n### 第一部分：单日爆发榜（必须包含榜单的数据更新时间）\n\n**输出要求**：\n\n- 必须直接完整输出表格内容\n- 禁止折叠、隐藏或展开表格\n- 禁止输出为文件格式\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\n\n- 标题格式：**🔥 【{分类名称}】单日爆发榜 （更新时间：{查询日期} 19:00）**（标题整体加粗）\n- 标题示例：**🔥 【化妆美容】单日爆发榜 （更新时间：2026-04-21 19:00）**\n\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\n\n| 排名 | 笔记信息                                         |      互动数       |       点赞        |       评论       |       收藏       |       分享        |\n| :--: | :----------------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\n|  🥇  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 22w+<br>↑新增23w+ | 22w+<br>↑新增21w+ | 893<br>↑新增21w+ | 1w+<br>↑新增21w+ | 1w+<br>↑新增21w+  |\n|  🥈  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 20w+<br>↑新增18w+ | 18w+<br>↑新增16w+ | 756<br>↑新增18w+ | 8k+<br>↑新增16w+ | 900+<br>↑新增16w+ |\n|  🥉  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 18w+<br>↑新增15w+ | 15w+<br>↑新增13w+ | 621<br>↑新增15w+ | 7k+<br>↑新增13w+ | 800+<br>↑新增13w+ |\n\n**字段详细说明**：\n\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\n- **笔记信息**：\n  - 第一行：笔记标题（可点击跳转）\n  - 第二行：[作者名](作者主页链接) 粉丝数+（作者名可点击跳转到作者主页，链接使用API返回的userJumpUrl字段，字号与标题一样大）\n- **互动数**：\n  - 第一行：累计互动数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **点赞**：\n  - 第一行：累计点赞数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **评论**：\n  - 第一行：累计评论数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **收藏**：\n  - 第一行：累计收藏数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n- **分享**：\n  - 第一行：累计分享数（格式：数字w+ 或 纯数字）\n  - 第二行：↑新增数字w+（\"↑新增\"字号小一号，正常文字颜色，不换行）\n  - **分享字段必须展示且不能出错**\n\n**重要说明**：\n\n- 使用标准 Markdown 表格格式\n- 单元格内使用 `<br>` 换行显示累计数据和新增数据\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\n- 新增数据格式：累计数据 <br> ↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\n- \"↑新增\"文案字号比累计数据小一号\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\n\n**数据说明（必须在表格上方、标题之后输出）**：\n\n- 在单日爆发榜标题之后、表格之前输出：_单日爆发榜指笔记发后第3天比第2天涨的数据由高到低Top50_\n\n**数据输出逻辑（必须严格执行）**：\n\n- **首次输出**：\n  - 单日爆发榜表格：显示TOP1到TOP20\n  - HTML页面：显示TOP1到TOP20（与热榜表格保持一致）\n  - **\"查看更多\"提示逻辑**（必须严格执行）：\n    - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\n    - 如果返回数据 > 20条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"（显示剩余数据条数）\n    - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\n- **用户输入\"查看更多\"后**：\n  - 单日爆发榜表格：输出TOP21到实际数据末尾（延续之前的TOP20）\n  - HTML页面：输出TOP1到实际数据末尾（完整数据，覆盖之前的HTML文件）\n\n### 第二部分：单日爆发笔记分析\n\n**输出要求**：\n\n- 必须直接完整输出3个模块内容（热门内容分析、爆款标题分析、最高数据作品分析）\n- 禁止折叠、隐藏或展开任何模块\n- 禁止输出为文件格式\n- 所有分析内容都基于获取到的所有数据\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\n- **必须包含3个模块，禁止遗漏**\n\n- 标题格式：**📊 单日爆发笔记分析**（加粗，不带Top数量）\n- 示例：**📊 单日爆发笔记分析**\n\n以下内容分析基于获取的全部数据（共{数据条数}条）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征                                                                                                                                                                           | 实际效果      | 参考笔记                           |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]<br>[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望                           | 互动率提升50% | [笔记标题链接3]<br>[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查                         | 收藏率提升55% | [笔记标题链接5]<br>[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力                                     | 曝光率提升40% | [笔记标题链接7]<br>[笔记标题链接8] |\n\n**📈爆款标题分析**\n\n| 标题类型 | 标题特征                                                                                                           | 标题模版         | 发布规律             | 参考标题                 |\n| :------- | :----------------------------------------------------------------------------------------------------------------- | :--------------- | :------------------- | :----------------------- |\n| 提问式   | 标题以疑问句开头，设置悬念或提出用户关心的问题，引发用户的好奇心和思考欲望，激发点击阅读或评论互动                 | \"你还在XX吗？\"   | 工作日早高峰效果最佳 | 这个方法你还在用吗？     |\n| 数字式   | 标题中包含具体的数字、数量或统计数据，利用人们对量化信息的偏好，增强内容的可信度和专业感，让用户觉得内容有价值     | \"XX个XX技巧\"     | 午餐时间点击率高     | 5个快速提升XX的技巧      |\n| 情绪词   | 使用具有强烈情感色彩的词汇或网络流行语，如\"绝了\"、\"太XX了\"等，直接触发用户的情绪反应，引发点赞、评论或分享行为     | \"太XX了！忍不住\" | 晚间黄金时段转化高   | 太好用了！忍不住分享给你 |\n| 利益点   | 直接在标题中明确承诺用户可以获得的具体利益或效果，如\"XX天就能XX\"、\"省XX元\"等，降低用户决策成本，提高点击率和收藏率 | \"XX天就能XX\"     | 深夜发布收藏率最高   | 7天就能看到明显效果      |\n\n**✨最高数据作品分析**\n\n| 维度     | 核心特征分析                                               | 参考笔记       |\n| :------- | :--------------------------------------------------------- | :------------- |\n| 最高点赞 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述<br>特征：详细特征说明<br>建议：具体建议 | [笔记标题链接] |\n\n### 第三部分：HTML页面\n\n**强制要求（必须严格遵守）**：\n\n- HTML页面是4项输出中的第3项，必须在单日爆发榜和单日分析之后输出\n- 不需要等待用户回复，单日分析输出后立即执行\n- **禁止只输出文件路径，必须直接输出HTML页面**\n- **禁止折叠输出**\n- 这是唯一允许输出的文件，其他内容禁止输出为文件\n\n**执行命令**：\n\n- **首次输出**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\n- **用户输入\"查看更多\"后**：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50`\n\n**文件特点**：\n\n- 可独立打开的HTML文件\n- 支持直接点击链接跳转\n- 支持导出图片和PDF功能（导出结果与页面显示完全一致，PDF和图片导出内容一定是正确的）\n- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为\"↑新增数值\"格式，整体字号增大1px\n- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据，分享字段必须展示且不能出错）\n\n## 数据输出逻辑详解\n\n**核心原则**：\n\n- 单日爆发榜表格与HTML页面必须保持数据一致性\n- 使用相同的API接口，禁止修改接口返回的顺序\n\n### 阶段一：首次输出\n\n1. **单日爆发榜表格**：\n   - 调用脚本获取数据（最多50条）\n   - 展示TOP1到TOP20（前20条）\n   - **\"查看更多\"提示逻辑（根据实际数据量动态调整）**：\n     - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\n     - 如果返回数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{实际剩余数量}条！✨\"\n     - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\n\n2. **HTML页面**：\n   - 执行命令：`python scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20`\n   - 生成HTML文件，包含TOP1到TOP20数据\n   - 与单日爆发榜表格数据完全一致\n\n### 阶段二：用户输入\"查看更多\"\n\n1. **单日爆发榜表格**：\n   - 继续展示TOP21到实际数据末尾（根据实际数据量）\n   - 延续首次输出的数据，不重复TOP1-20\n\n### 第四部分：订阅服务（紧接HTML页面之后输出，禁止跳过）\n\n**强制要求（必须严格遵守）**：\n\n- 必须在HTML页面输出完成后展示\n- 提供每日19:30推送小红书单日热门笔记TOP50的订阅选项\n- 用户可回复数字或\"取消\"\n- **禁止遗漏，禁止胡乱输出**\n\n**订阅服务内容（必须原样输出，禁止修改，禁止省略）**：\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\n**订阅逻辑**：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n\n**输出顺序（严格按此顺序执行，禁止混乱输出，禁止遗漏）**：\n\n1. 🔥 单日爆发榜（含更新时间）\n2. 📊 单日爆发笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n3. 📁 HTML页面（直接输出，禁止只输出路径）\n4. 订阅服务（推送选项）\n\n**重要提示（强制，禁止违反）**：\n\n- **必须严格包含以上4项内容，禁止遗漏**\n  - 🔥 单日爆发榜（含更新时间）\n  - 📊 单日爆发笔记分析（3个模块）\n  - 📁 HTML页面（直接输出页面，输出后继续执行订阅服务）\n  - **订阅服务（推送选项，必须在HTML页面之后立即输出，禁止跳过，禁止遗漏）**\n- **禁止胡乱输出，禁止输出其他内容**\n- **禁止输出顺序混乱，必须严格按照上述顺序**\n- **订阅服务必须强制执行，HTML页面输出完成后必须立即展示订阅服务，不能等待用户回复，不能跳过，不能遗漏**\n\n### 数据一致性保障\n\n- 两个脚本使用相同的API接口\n- 相同的API接口，禁止修改接口返回的顺序\n- 相同的数据字段和格式\n- 确保表格和HTML页面的排名、数据完全一致（禁止修改接口返回的顺序）\n\n## 操作步骤\n\n### 标准流程\n\n#### 第一步：分类匹配\n\n根据用户输入自动匹配合适的分类：\n\n**可用分类列表（共25个）**：\n综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼\n\n**匹配规则**：\n\n- 用户输入具体产品词（如\"睫毛膏\"）→ 匹配对应分类（\"化妆美容\"）\n- 用户输入领域词（如\"穿搭\"、\"美食\"）→ 直接匹配分类\n- 未指定分类 → 使用\"综合全部\"\n\n**关键词-分类映射示例**：\n\n```\n睫毛膏/口红/粉底 → 化妆美容\n穿搭/衣服/时尚 → 时尚穿搭\n美食/做饭/探店 → 美味佳肴\n猫/狗/宠物 → 宠物天地\n游戏/王者/电竞 → 休闲娱乐\n```\n\n#### 第二步：查询冷门爆款笔记\n\n- 用户输入关键词后，自动匹配对应分类（**不告知用户匹配到的分类名称**）\n- 查询该分类下的冷门爆款笔记（最多50条）\n- **根据实际数据量动态展示**：\n  - 如果返回数据 ≤ 20条：默认展示全部数据，不展示\"查看更多\"提示\n  - 如果返回数据 > 20条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余{数量}条！✨\"提示\n  - 如果返回数据 = 50条：默认展示TOP20，展示\"回复\"查看更多\"可看剩余30条！✨\"提示\n\n#### 第三步：日期判断\n\n根据用户输入和当前时间确定查询日期：\n\n**判断规则**：\n\n1. **用户指定了日期** → 直接使用指定日期\n2. **用户未指定日期**：\n   - 当前时间 >= 19:00 → 查询**昨日**数据（当日19:00已更新）\n   - 当前时间 < 19:00 → 查询**前天**数据（等待当日19:00更新）\n\n#### 第四步：获取单日爆发榜数据\n\n调用脚本获取榜单数据：\n\n```bash\npython scripts/xhs_daily_fetcher.py --keyword \"睫毛膏\" --top_n 50\n```\n\n**参数说明**：\n\n- `--category`：分类名称（可选）\n- `--keyword`：用户输入的关键词，用于自动匹配分类\n- `--rank_date`：查询日期（可选，自动判断）\n- `--top_n`：返回条数（默认50）\n\n**数据完整性要求**：\n\n- 确保表格所有字段和数据完整加载\n- 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\n- 直到所有字段（排名、笔记信息、互动数、点赞、评论、收藏、分享）都有完整数据\n- **分享字段使用正确的API字段名**：`AnaAddBean.useShareCount`（累计分享数）、`AnaAddBean.addShareCount`（新增分享数）\n- **确保分享数值正确输出，避免使用错误的字段名导致数值不对**\n\n#### 第五步：输出单日爆发榜和单日分析\n\n按照输出规范，依次输出：\n\n1. 单日爆发榜（含更新时间）\n2. 单日爆发笔记分析（3个模块）\n\n#### 第六步：生成HTML页面（4项输出中的第3项）\n\n**重要要求：HTML页面输出完成后必须继续执行第七步（订阅服务），HTML不是最后一步**\n\n生成可视化HTML页面：\n\n**首次输出时**：\n\n```bash\npython scripts/gen_xhs_html.py --keyword \"穿搭\" --top 20\n```\n\n**用户输入\"查看更多\"后**：\n\n```bash\npython scripts/gen_xhs_html.py --keyword \"穿搭\" --top 50\n```\n\n**输出格式（直接输出HTML页面，禁止只输出文件路径）**：\n\n#### 第七步：输出订阅服务（强制，禁止跳过，禁止遗漏）\n\n**必须在HTML页面输出完成后立即执行此步，不能等待用户回复，不能跳过，不能遗漏**\n\n直接输出以下内容（禁止修改，禁止省略）：\n\n```\n🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n```\n\n**订阅逻辑**：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n\n## 订阅服务说明\n\n### 订阅内容\n\n**小红书单日爆发笔记推荐TOP50**\n\n- 每日19:30更新\n- 推送当日的50篇热门内容\n- 包含完整分析和HTML文件\n\n### 订阅输出格式\n\n按上述4项输出顺序执行即可，与标准输出格式一致。\n\n## 使用示例\n\n### 示例1：关键词查询\n\n- **场景/输入**：\"帮我查一下睫毛膏相关的爆款笔记\"\n- **预期产出**：匹配化妆美容分类，依次输出单日爆发榜、单日分析、HTML页面、订阅服务\n\n### 示例2：泛查询热门内容\n\n- **场景/输入**：\"最近小红书有什么热门内容\"\n- **预期产出**：使用综合全部分类，依次输出4项内容\n\n## 资源索引\n\n- **脚本**：见 [scripts/xhs_daily_fetcher.py](scripts/xhs_daily_fetcher.py)\n  - 用途：获取小红书爆款内容榜单数据\n  - 参数：--category 分类名 / --keyword 关键词 / --top_n 条数\n- **脚本**：见 [scripts/gen_xhs_html.py](scripts/gen_xhs_html.py)\n  - 用途：生成可视化HTML页面\n  - 参数：--category 分类名 / --top 条数 / --output 输出路径\n\n## 注意事项\n\n- 数据每日19:00更新昨天的榜单\n- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含单日爆发榜（更新时间）+ 单日爆发笔记分析 + HTML页面 + 订阅服务\n  - 🔥 单日爆发榜（必须包含更新时间）\n  - 📊 单日爆发笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n  - 📁 HTML页面（直接输出HTML页面，禁止只输出文件路径）\n  - **订阅服务（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复）**：🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n  - **禁止输出遗漏，禁止胡乱输出，必须严格按照此4项内容输出，订阅服务与其他3项同等强制**\n- **输出格式要求（强制）**：\n  - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n  - **禁止输出文件**：除HTML页面外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n  - **输出顺序**：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务的顺序执行，禁止混乱输出\n- **输出顺序（严格按此顺序执行，禁止混乱输出）**：\n  1. **🔥 单日爆发榜**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）\n  2. **📊 单日爆发笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）\n  3. **📁 HTML页面**（4项输出中的第3项，直接输出HTML页面禁止只输出路径，输出后继续执行订阅服务）\n  4. **订阅服务（强制输出，禁止遗漏，禁止跳过，禁止等待用户回复，与前三项同等强制）**：HTML页面输出完成后立即原样输出订阅服务文案\n- **HTML页面输出要求（强制）**：\n  - 是4项输出中的第3项，直接输出HTML页面，禁止只输出文件路径\n  - **禁止只输出文件路径，必须直接输出HTML页面**\n  - **禁止折叠输出**\n  - **PDF和图片导出内容一定是正确的**\n  - 不需要等待任何流程\n- **订阅服务输出要求（强制，禁止遗漏）**：\n  - 订阅服务是4项输出内容之一，与其他3项同等强制，禁止遗漏\n  - 必须在HTML页面输出完成后立即展示，不能等待用户回复\n  - **禁止跳过，禁止遗漏，禁止等待用户回复，禁止折叠**\n  - 提供订阅选项：每日19:30推送小红书单日爆发笔记TOP50 或 暂不需要-仅本次查询\n  - 订阅逻辑：小红书单日爆发笔记推荐TOP50，按每日19:30更新\n  - 请用户回复数字或\"取消\"\n- **数据一致性要求**：单日爆发榜表格与HTML页面必须使用相同的数据源，禁止修改接口返回的顺序，确保完全一致\n- **数据完整性要求（强制）**：\n  - 表格所有字段和数据必须完整加载\n  - 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\n  - 直到所有字段都有完整数据（单日爆发榜7个字段、单日分析所有表格字段）\n- **数据输出逻辑（必须严格执行）**：\n  - 首次输出：单日爆发榜TOP1-20，HTML页面TOP1-20（保持一致）\n  - 查看更多：单日爆发榜TOP21-实际数据末尾，HTML页面TOP1-实际数据末尾（完整数据）\n  - **\"查看更多\"提示逻辑**：\n    - 数据 ≤ 20条：不展示\n    - 数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{数量}条！✨\"\n    - 数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"\n- 表格字段：排名、笔记信息、互动数（新增互动）、点赞（新增点赞）、评论（新增评论）、收藏（新增收藏）、分享（新增分享，**必须展示且不能出错，避免胡乱输出**）\n- 单日分析包含：热门内容分析、爆款标题分析、最高数据作品分析\n- 单日分析标题后显示\"以下内容分析基于获取的全部数据（共{数据条数}条）进行~\"\n- 分析内容从创作者视角出发，提供可执行建议\n- **禁止自动查询**：未订阅且未收到用户明确查询输入时，禁止自动调用脚本或输出任何热榜信息\n\nFile v1.0.0:_skillhub_meta.json\n\n{\n  \"name\": \"xhs-daily-ranking\",\n  \"installedAt\": 1777449681027,\n  \"source\": \"import\"\n}","readmeExcerpt":"Skill: 小红书每日爆款笔记 Owner: if530770 Summary: 小红书每日爆款笔记是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-06-05T03:33:07.637Z | user **v1.0.5 Changelog:** - Added English and Chinese README files for better documentation (README.en.md, README.md). - Removed outdated documentation file (","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"xhs-daily-ranking/\n├── scripts/\n│   ├── xhs_daily_fetcher.py   # 数据拉取、榜单生成核心脚本\n│   └── gen_xhs_html.py        # HTML可视化文件生成脚本\n├── references/\n│   └── core_workflow.md       # 完整功能流程规范（核心）\n├── requirements.txt           # 依赖声明\n└── SKILL.md                  # Skill定义文档"},{"language":"text","snippet":"用户请求 → 参数校验（日期/分类匹配） → 调用公开接口拉取数据\n    ↓\n生成Markdown榜单 → 规律分析 → 渲染HTML文件\n    ↓\n返回4项结果（榜单 + 分析 + HTML + 订阅选项）→ 用户响应"},{"language":"bash","snippet":"# 获取榜单数据（最多50条）\npython scripts/xhs_daily_fetcher.py --keyword \"{关键词}\" --top_n 50\n\n# 生成HTML页面\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 20   # 首次输出\npython scripts/gen_xhs_html.py --keyword \"{关键词}\" --top 50   # 查看更多"},{"language":"text","snippet":"🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。"},{"language":"text","snippet":"🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）\n1. 每日19:30-推送小红书单日爆发笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。"},{"language":"text","snippet":"睫毛膏/口红/粉底 → 化妆美容\n穿搭/衣服/时尚 → 时尚穿搭\n美食/做饭/探店 → 美味佳肴\n猫/狗/宠物 → 宠物天地\n游戏/王者/电竞 → 休闲娱乐"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: xiaohongshu-dailytop\r\ndescription: 小红书每日爆款笔记是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。\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- **各领域当日趋势追踪**：监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。\r\n- **创作灵感生成**：基于当日爆款内容，提炼可复用的选题、话术与呈现形式，直接用于你的下一篇笔记策划。\r\n\r\n适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。\r\n---\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n- **🔥 单日爆发榜查询**：获取当日热门笔记TOP50，按分类查询，支持25个垂直领域精准匹配\r\n- **📊 智能规律分析**：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告\r\n- **📈 多维度数据展示**：完整呈现互动数、点赞、评论、收藏、分享及新增数据\r\n- **🔔 自动订阅推送**：支持每日19:30固定时间推送最新榜单到消息栏\r\n\r\n### ✨ 特色亮点\r\n\r\n- **🏷️ 全分类覆盖**：综合全部、化妆美容、时尚穿搭、美味佳肴等 25 个主流分类\r\n- **🔍 智能分类匹配**：输入「睫毛膏」→ 化妆美容，无需手动选类（对用户不展示匹配结果）\r\n- **⏰ 灵活日期适配**：支持指定日期；未指定时按 19:00 更新规则自动判断查询日\r\n- **📄 双格式输出**：Markdown 表格 + 按需生成 HTML 页面，自用与汇报均可\r\n\r\n---\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n\r\n- Python 3.8 及以上\r\n- `requests`：`pip install requests`\r\n- [红狐Hub](https://redfox.hk/) 账号与 API Key（格式 `ak_xxxxxxxx`，新用户注册赠免费积分）\r\n\r\n### 安装方式\r\n\r\n#### SkillHub / ClawHub（推荐）\r\n\r\n1. 前往 [SkillHub](https://skillhub.cn) 或 [ClawHub](https://clawhub.ai)\r\n2. 搜索 **xiaohongshu-dailytop** 或 **小红书每日爆款笔记**\r\n3. 按平台指引安装技能包\r\n4. 在对话环境或本机配置 `REDFOX_API_KEY`（见下方）\r\n\r\n#### WorkBuddy / 龙虾（本地技能）\r\n\r\n1. 将本技能目录放入 WorkBuddy 的 `skills` 路径（如 `~/.workbuddy/skills/xiaohongshu-dailytop`）\r\n2. 在对话中通过技能名或描述触发（如「查小红书每日爆款笔记」「睫毛膏爆款」）\r\n3. 配置 `REDFOX_API_KEY` 后重启终端，确保 Agent 与脚本均可读取\r\n\r\n#### 命令行独立使用\r\n\r\n```bash\r\npip install requests\r\ncd xiaohongshu-dailytop\r\n# 步骤一：获取数据并写入缓存\r\npython scripts/xhs_daily_fetcher.py --keyword \"睫毛膏\" --top_n 50 --output_json /tmp/xhs_daily_cache.json\r\n# 步骤二：从缓存生成 HTML（跳过 API 调用）\r\npython scripts/gen_xhs_html.py --keyword \"睫毛膏\" --top 20 --input_json /tmp/xhs_daily_cache.json\r\n```\r\n\r\n### 环境变量配置\r\n\r\n| 变量名 | 必填 | 说明 |\r\n| --- | --- | --- |\r\n| `REDFOX_API_KEY` | 是 | 红狐 API 密钥，格式 `ak_xxxxxxxx` |\r\n\r\n**获取 API Key**：访问 [红狐Hub官网](https://redfox.hk/) → [注册/登录](https://redfox.hk/login) → 个人中心复制 Key。\r\n\r\n**macOS / Linux**：\r\n\r\n```bash\r\necho 'export REDFOX_API_KEY=<你的apikey>' >> ~/.zshrc\r\nsource ~/.zshrc\r\n```\r\n\r\n**Windows**（PowerShell）：\r\n\r\n```powershell\r\n[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<你的apikey>\", \"User\")\r\n```\r\n\r\n验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows）。未生效请重启终端。\r\n\r\n**Windows Git Bash 注意事项**：PowerShell 设置的用户级环境变量 Git Bash 可能无法读取，需在命令中显式注入：\r\n```bash\r\nexport REDFOX_API_KEY=\"ak_xxx\" && python scripts/xhs_daily_fetcher.py ...\r\n```\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n### 基础使用\r\n\r\n#### 1. 发起查询\r\n\r\n告诉助手关键词或领域（未指定分类则自动匹配，未指定日期则按 19:00 规则判断）：\r\n\r\n> 用户：帮我查一下睫毛膏相关的爆款笔记\r\n>\r\n> 助手：依次输出每日爆款笔记 TOP20、每日爆款笔记分析、功能服务询问\r\n\r\n#### 2. 查看更多\r\n\r\n默认 TOP20；数据超过 20 条时可回复「查看更多」：\r\n\r\n> 用户：查看更多\r\n>\r\n> 助手：展示 TOP21 至榜单末尾\r\n\r\n#### 3. 生成 HTML 文件包\r\n\r\n在功能服务询问后，回复\"2\"或\"生成\"：\r\n\r\n> 用户：2\r\n>\r\n> 助手：生成小红书风格的 HTML 文件包，支持导出 PDF\r\n\r\n#### 4. 订阅推送\r\n\r\n在功能服务询问后，回复\"1\"或\"订阅\""},{"path":"README.md","content":"# 小红书每日爆款笔记 / xiaohongshu-dailytop\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- 支持每日 19:30 订阅推送，持续跟踪赛道热点变化\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- **单日爆发榜查询**：获取当日热门笔记 TOP50，支持 25 个垂直领域精准匹配\r\n- **智能规律分析**：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告\r\n- **多维度数据展示**：完整呈现互动数、点赞、评论、收藏、分享及新增数据\r\n- **自动订阅推送**：支持每日 19:30 固定时间推送最新榜单\r\n\r\n### 特色亮点\r\n\r\n- 输入「睫毛膏」自动匹配「化妆美容」分类，无需手动选类\r\n- 首次输出 TOP20，回复「查看更多」加载剩余，HTML 同步扩展为全量\r\n- 榜单表格与 HTML 页面数据来源、顺序完全一致\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\r\n- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。\r\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\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| ------------ | ---------------------------------- | ----------------------------------------------------------------- |\r\n| 查当日爆款   | `帮我查一下睫毛膏相关的爆款笔记`   | 自动匹配分类，输出当日爆发榜 TOP20 + 三维度分析 + HTML + 订阅选项 |\r\n| 查泛热门内容 | `最近小红书有什么热门内容`         | 使用「综合全部」分类查询，完整四段输出                            |\r\n| 查指定日期   | `查 2026-04-20 美妆类每日爆款笔记` | 指定日期查询对应分类单日爆发榜                                    |\r\n| 加载更多     | 回复「查看更多」                   | 展示 TOP21 至末尾，HTML 同步刷新为全量数据                        |\r\n| 订阅推送     | 输出完成后回复 `1`                 | 开通每日 19:30 推送小红书每日爆款笔记 TOP50                       |\r\n\r\n### 输出示例\r\n\r\n每次查询固定四段输出：每日爆款笔记榜单 → 三维度规律分析 → HTML 可视化页面 → 订阅服务选项。\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景         | 角色            | 示例问法                                 | 收益                                                   |\r\n| ------------ | --------------- | ---------------------------------------- | ------------------------------------------------------ |\r\n| 每日爆款灵感 | 美妆 / 穿搭博主 | `查一下今天化妆美容爆款笔记`             | 提炼当日爆款标题结构与内容特征，直接用于下一篇笔记策划 |\r\n| 当日热点追踪 | 品牌小红书运营  | `订阅穿搭类每日爆款推送`                 | 持续跟踪赛道变化，热点响应更及时                       |\r\n| 潜力笔记挖掘 | MCN 内容星探    | `今天美食类有哪些低粉高互动的爆发笔记？` | 结合互动新增数据发现成长型账号                         |\r\n| 每日数据复盘 | 增长 / 数据分析 | `查今天科技类 TOP50 并导出 HTML`         | 导出 PDF 纳入日报，数据口径统一可存档                  |"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"xhs-daily-ranking\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1780630387637\n}"},{"path":"references/core_workflow.md","content":"# 小红书每日爆款笔记 · 核心工作流程\r\n\r\n> Agent 执行本技能时须完整遵循本文档。用户向导读见 [SKILL.md](../SKILL.md)。\r\n\r\n## 任务目标\r\n\r\n- 本 Skill 用于：获取小红书平台爆款内容榜单数据\r\n- 能力包含：\r\n  - 每日爆款笔记数据获取（按分类查询）\r\n  - 每日爆款笔记智能分析\r\n  - 冷门爆款笔记挖掘（关键词匹配分类）\r\n  - 订阅服务（每日定时推送）\r\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\r\n\r\n## 数据接口更新规则\r\n\r\n- **更新时间**：每天19:00更新昨天的榜单数据\r\n- **数据范围**：当日的热门笔记TOP50\r\n- **分类覆盖**：25个垂直领域分类\r\n- **接口地址**：`https://redfox.hk/story/api/cozeSkill/getXhsCozeSkillDataOne`\r\n- **请求方式**：**GET**（query 参数：`rankDate`、`source`、`category`）；**禁止使用 POST**（会返回系统内部错误）\r\n- **认证方式**：请求头 `X-API-KEY`，从环境变量 `REDFOX_API_KEY` 获取；脚本通过 `requests.get` 发起请求\r\n\r\n## 鉴权\r\n\r\n### 获取 API Key\r\n\r\n1. 访问 [RedFox 官网](https://redfox.hk/) 了解服务详情\r\n2. 前往 [注册页面](https://redfox.hk/login) 注册账号\r\n3. **新注册用户将获赠免费积分**，可立即开始使用 API 服务\r\n4. 注册登录后，在个人中心获取 API Key，格式为 `ak_xxxxxxxx`\r\n\r\n### 配置 API Key\r\n\r\n- `REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`\r\n- 若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若用户不会配置，Agent 应主动帮用户设置：\r\n  - **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效\r\n  - **Windows**：使用 `[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<值>\", \"User\")` 设置用户级永久环境变量（需重启终端生效）\r\n  - 配置完成后应验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确保换一个 skill 也能读取到\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- 每日爆款笔记表格与HTML页面数据必须完全一致（相同顺序、相同内容）\r\n- 两个脚本使用相同的API接口，禁止修改接口返回的顺序\r\n- 禁止胡乱渲染或使用不同数据源\r\n\r\n**输出内容必须严格包含以下三部分，禁止遗漏或胡乱输出：**\r\n\r\n- **每日爆款笔记（更新时间）**：必须直接输出，禁止折叠，禁止遗漏\r\n- **每日爆款笔记分析**：必须直接输出，禁止折叠，禁止遗漏\r\n- **功能服务询问**：必须在每日分析之后强制输出，禁止跳过，禁止遗漏，禁止等待用户回复\r\n\r\n**输出格式要求（强制执行）**：\r\n\r\n- **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\r\n- **禁止输出文件**：禁止输出任何其他文件（如CSV、JSON、TXT等）\r\n- **输出顺序**：严格按照每日爆款笔记 → 每日分析 → 功能服务询问的顺序执行，禁止混乱输出\r\n- **HTML页面改为按需生成**：不再强制自动生成HTML，改为在功能服务询问中让用户选择是否生成。用户回复\"2\"或\"生成\"后才执行 gen_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）**（标题整体加粗）\r\n- 标题示例：**🔥 【化妆美容】每日爆款笔记 （更新时间：2026-04-21 19:00）**\r\n\r\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\r\n\r\n| 排名 | 笔记信息                                         |      互动数       |       点赞        |       评论       |       收藏       |       分享        |\r\n| :--: | :----------------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\r\n|  🥇  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 22w+<br>↑新增23w+ | 22w+<br>↑新增21w+ | 893<br>↑新增21w+ | 1w+<br>↑新增21w+ | 1w+<br>↑新增21w+  |\r\n|  🥈  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 20w+<br>↑新增18w+ | 18w+<br>↑新增16w+ | 756<br>↑新增18w+ | 8k+<br>↑新增16w+ | 900+<br>↑新增16w+ |\r\n|  🥉  | [笔记标题链接]<br>[作者名](作者主页链接) 粉丝数+ | 18w+<br>↑新增15w+ | 15w+<br>↑新增13w+ | 621<br>↑新增15w+ | 7k+<br>↑新增13w+ | 800+<br>↑新增13w+ |\r\n\r\n**字段详细说明**：\r\n\r\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\r\n- **笔记信息**：\r\n  - 第一行"},{"path":"README.en.md","content":"# Xiaohongshu Daily Viral Notes / xiaohongshu-dailytop\r\n\r\n---\r\n\r\n## Introduction\r\n\r\nQuery the TOP50 Xiaohongshu notes with the highest same-day engagement growth by keyword or track, with automatic breakdown of titles, content patterns, and trends — helping creators and operators catch the traffic wave and plan the next post.\r\n\r\n**Core Value**\r\n\r\n- Tracks notes with the highest engagement increment today, not cumulative totals — capturing content that is actively exploding right now\r\n- Three-dimension analysis (hot content, viral titles, top-data posts) delivered in one pass, ready to feed directly into topic planning\r\n- Supports daily 19:30 subscription pushes to continuously track track trend changes\r\n\r\n**Who It's For**\r\n\r\n- ✍️ Beauty / fashion and other vertical creators — find daily benchmark notes and extract replicable title structures and content formulas\r\n- 📢 FMCG brand operators — stay on top of today's breakout content to guide placements and seeding direction\r\n- 🔍 MCN talent scouts — spot low-follower high-engagement breakout notes to assess account growth potential\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Single-day breakout rankings**: Fetch today's hot notes TOP50, supporting 25 vertical categories with precise matching\r\n- **Smart pattern analysis**: Generate three-dimension reports — hot content analysis, viral title analysis, top-data post analysis\r\n- **Multi-dimension data display**: Full presentation of total engagement, likes, comments, collects, shares, and new incremental data\r\n- **Auto subscription push**: Subscribe to receive the latest rankings at a fixed time of 19:30 every day\r\n\r\n### Highlights\r\n\r\n- Input \"mascara\" and it auto-matches \"Beauty & Makeup\" — no manual category selection needed\r\n- First output shows TOP20; reply \"load more\" to get the rest, with HTML synced to full data\r\n- Ranking table and HTML page share the same data source and order — fully consistent\r\n\r\n---\r\n\r\n## API Key Acquisition & Security\r\n\r\n- This skill requires the environment variable: `REDFOX_API_KEY`.\r\n- `REDFOX_API_KEY` is provided by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`).\r\n- Visit [RedFoxHub](https://redfox.hk?source=github) to register and obtain your `REDFOX_API_KEY`.\r\n- Configure the `REDFOX_API_KEY` environment variable on your device before using this skill.\r\n- Before using a key, confirm its source, scope, expiry, and whether it supports reset or revocation.\r\n- Never hard-code or expose the key in plaintext within code, prompts, logs, or output files.\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\nDescribe 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| ------------------------- | ---------------------------------------------- | ---------------------------------------"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"小红书每日爆款笔记是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。 Skill: 小红书每日爆款笔记 Owner: if530770 Summary: 小红书每日爆款笔记是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-06-05T03:33:07.637Z | user **v1.0.5 Changelog:** - Added English and Chinese README files for better documentation (README.en.md, README.md). - Removed outdated documentation file (","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1084,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T01:33:20.838Z","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-11T01:33:20.838Z","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-11T03:56:43.225Z","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"}]}}}