{"id":"05040318-f83a-456b-a09e-6b6a9ae0034e","entityType":"agent","slug":"clawhub-if530770-xhs-weekly-ranking","name":"小红书七日爆款笔记","canonicalUrl":"https://www.xpersona.co/agent/clawhub-if530770-xhs-weekly-ranking","canonicalPath":"/agent/clawhub-if530770-xhs-weekly-ranking","generatedAt":"2026-10-12T05:32:14.095Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T18:43:03.058Z","emptyReason":null},"description":"专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送。创作者可查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感。 Skill: 小红书七日爆款笔记 Owner: if530770 Summary: 专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送。创作者可查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-06-05T03:40:04.132Z | user xhs-weekly-ranking 1.0.5 - No changes detected compared to the previous version. - All features, documentation, and behavior remain consistent with the previous release. v1.0.4 | 2026-06-05T03:39:00.53","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17dj64hf08x3mak1j99vesphd84gs9c:xhs-weekly-ranking","sourceUrl":"https://clawhub.ai/if530770/xhs-weekly-ranking","homepage":"https://clawhub.ai/if530770/skills/xhs-weekly-ranking","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/if530770/xhs-weekly-ranking","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/if530770/skills/xhs-weekly-ranking","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送。创作者可查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感。 Skill: 小红书七日爆款笔记 Owner: if530770 Summary: 专注于小红书平台的内容趋势分析，基于"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T18:43:03.058Z","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-11T18:43:03.058Z","emptyReason":null},"stars":null,"forks":null,"downloads":1008,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.0.5","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T18:43:03.041Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T18:43:03.058Z","lastCrawledAt":"2026-10-11T18:43:03.041Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T18:43:03.041Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.5","createdAt":"2026-06-05T03:40:04.132Z","changelog":"xhs-weekly-ranking 1.0.5 - No changes detected compared to the previous version. - All features, documentation, and behavior remain consistent with the previous release.","fileCount":9,"zipByteSize":48080},{"version":"1.0.4","createdAt":"2026-06-05T03:39:00.530Z","changelog":"**Skill renamed and documentation fully rewritten for clarity, with workflow and setup details improved.** - Skill名称由“xhs-weekly-ranking”变更为“xiaohongshu-weeklytop”并统一全新描述。 - 完全重写并优化Skill说明文档，结构更清晰，补充了目录结构、脚本安装方法、API鉴权流程及常见问答。 - 新增脚本说明与命令行用法示例，详细列明TOP20/50切换、HTML生成、订阅推送等关键功能调用方式。 - 明确Agent执行前须严格遵循核心工作流（core_workflow.md），并增强输出流程、数据一致性及错误排查说明。 - 移除旧有Skill元信息与卡片文件，新增多语言README和可视化HTML样例（README.en.md、README.md、scripts/xhs_weekly.html）。","fileCount":9,"zipByteSize":47963},{"version":"1.0.3","createdAt":"2026-05-08T11:30:42.852Z","changelog":"- 文档“简介”部分补充了热榜功能介绍，突出趋势分析、内容特征识别及创作建议等新亮点 - 优化“简介”描述，更突出每日订阅、热门内容深度洞察、形式对比等能力 - 其他内容、功能与用法保持一致，无新增核心功能或接口变更","fileCount":7,"zipByteSize":31959},{"version":"1.0.2","createdAt":"2026-04-29T12:41:31.068Z","changelog":"xhs-weekly-ranking 1.0.2 - No file changes detected in this version. - No user-facing updates or feature modifications.","fileCount":6,"zipByteSize":30310},{"version":"1.0.1","createdAt":"2026-04-29T12:18:56.735Z","changelog":"- 更新 SKILL.md，简化和精简“使用场景”表格，删除“预期收益”一列 - 其余功能、描述和使用说明保持不变 - 无实际代码或功能改变，仅文档内容微调","fileCount":6,"zipByteSize":31381},{"version":"1.0.0","createdAt":"2026-04-29T12:12:51.970Z","changelog":"xhs-weekly-ranking 1.0.0 – 初始发布 - 发布小红书爆款内容榜单助手，支持按25大类查询往前7天热门笔记TOP50，无需账号或API密钥 - 自动生成内容分析、爆款标题规律拆解、最高数据作品分析报告，并支持Markdown与HTML可视化导出 - 提供\"查看更多\"与每日19:30订阅推送功能，提升爆款内容获取与跟踪效率 - 支持关键词智能分类匹配及灵活日期适配，覆盖品牌方、MCN、自媒体等内容创作与运营需求","fileCount":6,"zipByteSize":31509}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17dj64hf08x3mak1j99vesphd84gs9c:xhs-weekly-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-weekly-ranking/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-weekly-ranking/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-weekly-ranking/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-weekly-ranking/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-weekly-ranking/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-weekly-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-12T05:32:14.092Z"}},"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-weekly-ranking/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-weekly-ranking/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-weekly-ranking/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-xhs-weekly-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-11T18:43:03.058Z","emptyReason":null},"readme":"Skill: 小红书七日爆款笔记\n\nOwner: if530770\n\nSummary: 专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送。创作者可查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感。\n\nTags: latest:1.0.5\n\nVersion history:\n\nv1.0.5 | 2026-06-05T03:40:04.132Z | user\n\nxhs-weekly-ranking 1.0.5\n\n- No changes detected compared to the previous version.\n- All features, documentation, and behavior remain consistent with the previous release.\n\nv1.0.4 | 2026-06-05T03:39:00.530Z | user\n\n**Skill renamed and documentation fully rewritten for clarity, with workflow and setup details improved.**\n\n- Skill名称由“xhs-weekly-ranking”变更为“xiaohongshu-weeklytop”并统一全新描述。\n- 完全重写并优化Skill说明文档，结构更清晰，补充了目录结构、脚本安装方法、API鉴权流程及常见问答。\n- 新增脚本说明与命令行用法示例，详细列明TOP20/50切换、HTML生成、订阅推送等关键功能调用方式。\n- 明确Agent执行前须严格遵循核心工作流（core_workflow.md），并增强输出流程、数据一致性及错误排查说明。\n- 移除旧有Skill元信息与卡片文件，新增多语言README和可视化HTML样例（README.en.md、README.md、scripts/xhs_weekly.html）。\n\nv1.0.3 | 2026-05-08T11:30:42.852Z | user\n\n- 文档“简介”部分补充了热榜功能介绍，突出趋势分析、内容特征识别及创作建议等新亮点\n- 优化“简介”描述，更突出每日订阅、热门内容深度洞察、形式对比等能力\n- 其他内容、功能与用法保持一致，无新增核心功能或接口变更\n\nv1.0.2 | 2026-04-29T12:41:31.068Z | user\n\nxhs-weekly-ranking 1.0.2\n\n- No file changes detected in this version.\n- No user-facing updates or feature modifications.\n\nv1.0.1 | 2026-04-29T12:18:56.735Z | user\n\n- 更新 SKILL.md，简化和精简“使用场景”表格，删除“预期收益”一列\n- 其余功能、描述和使用说明保持不变\n- 无实际代码或功能改变，仅文档内容微调\n\nv1.0.0 | 2026-04-29T12:12:51.970Z | user\n\nxhs-weekly-ranking 1.0.0 – 初始发布\n\n- 发布小红书爆款内容榜单助手，支持按25大类查询往前7天热门笔记TOP50，无需账号或API密钥\n- 自动生成内容分析、爆款标题规律拆解、最高数据作品分析报告，并支持Markdown与HTML可视化导出\n- 提供\"查看更多\"与每日19:30订阅推送功能，提升爆款内容获取与跟踪效率\n- 支持关键词智能分类匹配及灵活日期适配，覆盖品牌方、MCN、自媒体等内容创作与运营需求\n\nArchive index:\n\nArchive v1.0.5: 9 files, 48080 bytes\n\nFiles: README.en.md (5712b), README.md (4613b), references/core_workflow.md (33881b), scripts/gen_xhs_html.py (21731b), scripts/xhs_weekly_fetcher.py (29737b), scripts/xhs_weekly.html (38663b), skill-card.md (2624b), SKILL.md (12528b), _meta.json (137b)\n\nFile v1.0.5:SKILL.md\n\n---\r\nname: xiaohongshu-weeklytop\r\ndescription: 专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送。创作者可查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感。\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- 支持关键词自动匹配 25 个垂直分类，降低查询门槛\r\n\r\n**适用对象**：品牌方、MCN 机构、小红书博主、内容运营、增长团队\r\n\r\n**技术基础**：Python 3 + RedFox 小红书数据 API，数据每日 19:00 更新\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n| 功能 | 说明 |\r\n|------|------|\r\n| 📊 近日热榜查询 |按分类查询热门笔记，覆盖美妆、穿搭、美食、家居等25个垂直领域，快速掌握当下流量风向 |\r\n| 📈 七日热门分析 | 基于近7天各分类TOP50热门笔记的深度洞察，从流行趋势、热门话题深度分析、实用价值等维度拆解爆款共性 |\r\n| 🔍 形式规律对比 | 自动识别高质量封面、情绪共鸣点、实用价值、紧跟热点等爆款要素，提炼可复用的创作范式 |\r\n| 📁 创作建议输出 | 基于分析结果，提供可执行的选题方向、差异化策略、高维作品拆解建议 |\r\n| 🔔 订阅推送 | 定时推送最新趋势分析报告，持续跟踪赛道热点，不错过任何一个流量机会 |\r\n\r\n### ✨ 特色亮点\r\n\r\n- **⚡ 数据一致**：七日爆款笔记表格与 HTML 页面使用相同数据源与排序逻辑，排名完全一致\r\n- **📱 分页展示**：首次展示 TOP20，回复「查看更多」可加载剩余数据\r\n- **🎯 冷门爆款**：聚焦低粉高互动笔记，适合挖掘可对标样本\r\n- **🔒 零配置调用**：Agent 执行时自动判断查询日期，无需手动维护\r\n\r\n---\r\n\r\n## 鉴权\r\n\r\n### 获取 API Key\r\n\r\n1. 访问 [红狐Hub 官网](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\r\n若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若不会配置，Agent 可主动帮用户设置：\r\n\r\n- **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效\r\n- **Windows**：使用 `[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<值>\", \"User\")` 设置用户级永久环境变量（需重启终端生效）\r\n\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- Python 3.8+\r\n- 网络可访问 `redfox.hk` 数据 API\r\n- 已安装 `requests` 库（`pip install requests`）\r\n- 已配置 `REDFOX_API_KEY` 环境变量（参见上方「鉴权」章节）\r\n\r\n### 安装方式\r\n\r\n#### 方式一：WorkBuddy / Cursor Skills（推荐）\r\n\r\n1. 将本 Skill 目录放置于 Skills 工作区（如 `~/.workbuddy/skills/xiaohongshu-weeklytop`）\r\n2. 确保目录结构完整：`SKILL.md`、`references/`、`scripts/`\r\n3. 在对话中直接触发，例如：\r\n - 「帮我查一下睫毛膏相关的爆款笔记」\r\n - 「最近小红书有什么热门内容」\r\n - 「查看穿搭领域七日热榜」\r\n\r\n#### 方式二：命令行独立运行\r\n\r\n```bash\r\n# 进入 Skill 目录\r\ncd xiaohongshu-weeklytop\r\n\r\n# 获取榜单数据（JSON 输出）\r\npython scripts/xhs_weekly_fetcher.py --keyword \"睫毛膏\" --top_n 50\r\n\r\n# 生成 HTML 报告（从已获取的数据文件读取，不再调用API）\r\npython scripts/gen_xhs_html.py --data_file \"xhs_data.json\" --category \"化妆美容\" --top 20\r\n```\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n> **执行约束（强制）**：Agent 执行本 Skill 时，**必须先完整阅读并严格遵循** [references/core_workflow.md](references/core_workflow.md) 中的调用 Key 说明、输出规范、操作步骤与注意事项。以下为基础用法摘要，详细流程以核心工作流文档为准。\r\n\r\n### 基础使用\r\n\r\n#### 1. 关键词查询爆款\r\n\r\n> **用户**：帮我查一下睫毛膏相关的爆款笔记\r\n>\r\n> **助手**：自动匹配「化妆美容」分类 → 获取 TOP50 数据 → 输出七日爆款笔记 TOP20 → 七日分析 → 功能询问（HTML+订阅）\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> **助手**：延续输出 TOP21 至末尾 → 如用户选择生成 HTML，从已获取数据文件读取完整数据重新生成\r\n\r\n### 高级使用\r\n\r\n#### 1. 指定日期查询\r\n\r\n> **用户**：查看 2026-04-15 穿搭领域热榜\r\n>\r\n> **助手**：使用 `--rank_date \"2026-04-15\"` 查询指定日期数据\r\n\r\n#### 2. 直接指定分类\r\n\r\n```bash\r\npython scripts/xhs_weekly_fetcher.py --category \"时尚穿搭\" --top_n 50\r\npython scripts/gen_xhs_html.py --category \"时尚穿搭\" --top 50\r\n```\r\n\r\n#### 3. 订阅每日推送 / 生成 HTML\r\n\r\n首次查询完成后，助手会展示功能询问：回复 `1` 订阅每日 19:30 推送，回复 `2` 生成小红书风格 HTML 文件包。HTML 生成后会自动在对话中预览展示（优先 `preview_url`，未正常展示则用 `open_result_view` 兜底），无需手动查找文件。\r\n\r\n#### 4. 自定义 HTML 输出路径\r\n\r\n```bash\r\npython scripts/gen_xhs_html.py --data_file \"xhs_data.json\" --category \"穿搭\" --top 20 --output ./reports/小红书七日爆款笔记_穿搭.html\r\n```\r\n\r\n### 常用命令速查\r\n\r\n| 命令 / 场景 | 功能 |\r\n|-------------|------|\r\n| `python scripts/xhs_weekly_fetcher.py --keyword \"{词}\" --top_n 50` | 获取榜单原始数据 |\r\n| `python scripts/gen_xhs_html.py --data_file \"{文件}\" --category \"{分类}\" --top 20` | 首次生成 HTML（TOP20，从数据文件读取） |\r\n| `python scripts/gen_xhs_html.py --data_file \"{文件}\" --category \"{分类}\" --top 50` | 查看更多后生成完整 HTML |\r\n| 用户说「查看更多」 | 输出 TOP21+ |\r\n| 用户回复 `1` / \"订阅\" | 订阅每日 19:30 推送 |\r\n| 用户回复 `2` / \"html\" / \"生成\" | 生成 HTML 文件包 |\r\n\r\n### 核心工作流引用\r\n\r\n完整执行规范（输出格式、调用 Key、表格字段、数据一致性、订阅逻辑、使用示例等）见：\r\n\r\n**→ [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\n1. 输入赛道关键词（如「护肤」「穿搭」）\r\n2. 查看七日爆款笔记 TOP20 与七日分析\r\n3. 对标参考笔记的标题结构与内容特征\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 报告供团队复盘\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\n1. 按达人赛道查询七日热榜\r\n2. 拆解爆款标题类型与发布规律\r\n3. 订阅每日推送，持续跟踪热点\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\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-weeklytop/\r\n├── SKILL.md # Skill 入口与使用说明（本文件）\r\n├── references/\r\n│ └── core_workflow.md # 核心执行流程与输出规范（Agent 必读）\r\n└── scripts/\r\n ├── xhs_weekly_fetcher.py # 榜单数据获取脚本\r\n └── gen_xhs_html.py # HTML 可视化报告生成脚本\r\n```\r\n\r\n### 技术栈\r\n\r\n| 项目 | 说明 |\r\n|------|------|\r\n| 运行环境 | Python 3.8+ |\r\n| HTTP 请求 | `requests`（原生 Python） |\r\n| 数据来源 | RedFox 小红书 Coze Skill API |\r\n| 输出格式 | Markdown 表格 + 独立 HTML 文件 |\r\n| 部署平台 | WorkBuddy / Cursor Agent Skills |\r\n\r\n### 核心模块\r\n\r\n| 模块 | 文件 | 职责 |\r\n|------|------|------|\r\n| 数据获取 | `xhs_weekly_fetcher.py` | 调用 API、分类匹配、日期判断、排序输出 |\r\n| 报告生成 | `gen_xhs_html.py` | 从已获取的 JSON 数据文件渲染 HTML 页面，支持 PDF/图片导出 |\r\n| 执行规范 | `core_workflow.md` | 定义输出格式、调用 Key、三步流程、功能询问等强制约束 |\r\n\r\n\r\n\r\n### 数据更新规则\r\n\r\n- **更新时间**：每天 19:00 更新昨日榜单\r\n- **数据范围**：往前 7 天热门笔记 TOP50\r\n- **分类覆盖**：25 个垂直领域\r\n- **日期判断**：当前时间 ≥ 19:00 查昨日，< 19:00 查前天\r\n\r\n---\r\n\r\n## 常见问答\r\n\r\n### 安装相关问题\r\n\r\n**Q1: 脚本运行报错 `ModuleNotFoundError: requests`？**\r\n\r\nA: 该依赖为标准 Python HTTP 库。请运行 `pip install requests` 安装。若在虚拟环境中运行，请确保已激活对应环境。\r\n\r\n**Q2: 脚本提示「未找到 REDFOX_API_KEY」？**\r\n\r\nA: 请按照上方「鉴权」章节完成 API Key 的获取和配置。确保环境变量 `REDFOX_API_KEY` 已正确设置且格式为 `ak_xxxxxxxx`。\r\n\r\n**Q3: 如何将 Skill 添加到 Cursor / WorkBuddy？**\r\n\r\nA: 将 `xiaohongshu-weeklytop` 文件夹放入 Skills 目录，Agent 会根据 `description` 自动匹配触发。对话中提及「小红书热门」「爆款笔记」等关键词即可调用。\r\n\r\n---\r\n\r\n### 使用相关问题\r\n\r\n**Q4: 数据多久更新一次？**\r\n\r\nA: 榜单数据每日 19:00 更新（更新的是昨日数据）。订阅推送时间为每日 19:30。\r\n\r\n**Q5: 为什么有时查的是「前天」而不是「昨天」？**\r\n\r\nA: 当日 19:00 之前，最新榜单尚未更新，系统自动查询前天数据。19:00 之后则查询昨日数据。详见 [core_workflow.md](references/core_workflow.md) 日期判断规则。\r\n\r\n\r\n---\r\n\r\n### 故障排除\r\n\r\n**Q6: 七日爆款笔记表格与 HTML 数据不一致？**\r\n\r\nA: HTML 生成时从已获取的 JSON 数据文件读取，与表格使用完全相同的原始数据。检查是否使用了不同的 `--top` 参数。\r\n\r\n**Q7: API 请求失败或无数据？**\r\n\r\nA: 按以下步骤排查：\r\n1. 确认网络可访问 [红狐Hub 官网](https://redfox.hk/)\r\n2. 检查 `--rank_date` 是否为有效日期\r\n3. 尝试更换关键词或指定 `--category`\r\n4. 19:00 前查询时，确认是否应使用前天日期\r\n\r\n---\r\n\r\n### 执行规范\r\n\r\n**Q8: Agent 执行时必须遵守哪些规则？**\r\n\r\nA: 必须完整遵循 [references/core_workflow.md](references/core_workflow.md)，包括但不限于：\r\n- 调用 Key 说明（脚本参数与 top_n/top 取值规范）\r\n- 三步输出顺序（七日爆款笔记 → 分析 → 功能询问）\r\n- 禁止折叠输出、禁止输出除 HTML 外的文件\r\n- 首次 TOP20 + 查看更多逻辑\r\n- HTML 生成时从已获取数据文件读取，禁止再次调用 API\r\n- HTML 生成后必须调用 preview_url 在对话中直接展示页面；若未正常展示则用 open_result_view 兜底\r\n- 功能询问在分析之后立即展示，禁止跳过\n\nFile v1.0.5:README.md\n\n# 小红书七日爆款笔记 / xiaohongshu-weeklytop\r\n\r\n---\r\n\r\n## 简介\r\n\r\n专为内容创作者与运营人员设计的小红书七日爆款笔记工具，基于近 7 天热门笔记 TOP50 深度洞察，一键获取垂直领域热榜与创作分析。\r\n\r\n**核心价值**\r\n\r\n- 解决「不知道当下什么内容火、为什么火」的选题难题，7 天维度比单日更稳定可信\r\n- 实时热榜 + 智能分析 + 可导出 HTML 报告，支撑复盘与创作决策\r\n- 支持关键词自动匹配 25 个垂直分类，降低查询门槛\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- **近日热榜查询**：按分类查询近 7 天热门笔记，覆盖 25 个垂直领域，快速掌握当下流量风向\r\n- **七日热门分析**：从流行趋势、热门话题、实用价值等维度深度拆解爆款共性\r\n- **形式规律对比**：自动识别高质量封面、情绪共鸣点、实用价值、紧跟热点等爆款要素\r\n- **创作建议输出**：提供可执行的选题方向、差异化策略与高维作品拆解建议\r\n- **订阅推送**：每日 19:30 定时推送最新趋势分析报告\r\n\r\n### 特色亮点\r\n\r\n- 热榜表格与 HTML 页面使用相同数据源与排序逻辑，排名完全一致\r\n- 首次展示 TOP20，回复「查看更多」可加载剩余数据，HTML 同步更新为全量\r\n- 聚焦低粉高互动笔记，适合挖掘可对标的真实爆款样本\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/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-15 穿搭领域热榜` | 指定日期获取对应数据 |\r\n| 加载更多 | 回复「查看更多」 | 延续输出 TOP21 至末尾，HTML 重新生成为完整版本 |\r\n| 订阅每日推送 | 输出完成后回复 `1` | 开通每日 19:30 七日爆款笔记推送 |\r\n\r\n### 输出示例\r\n\r\n每次查询固定四段输出：近日热榜 TOP20 → 七日爆款分析（趋势 + 话题 + 形式规律）→ HTML 可视化页面 → 订阅服务选项。\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景 | 角色 | 示例问法 | 收益 |\r\n| ------------ | --------------- | --------------------------------- | ------------------------------------------------ |\r\n| 博主选题灵感 | 小红书新人博主 | `查一下护肤领域七日热榜` | 快速找到可借鉴的选题方向，降低冷启动试错成本 |\r\n| 品牌竞品监测 | 品牌营销经理 | `查口红相关的七日爆款并导出 HTML` | 掌握品类内容风向，优化投放与种草策略 |\r\n| 达人运营复盘 | MCN 运营人员 | `查穿搭领域七日热榜并订阅推送` | 拆解爆款标题类型，持续跟踪热点为达人提供选题参考 |\r\n| 数据洞察汇报 | 增长 / 数据分析 | `查美食类完整 TOP50 并导出 HTML` | 获得可分享、可归档的数据报告，支撑周报与策略会 |\n\nFile v1.0.5:_meta.json\n\n{\n \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n \"slug\": \"xhs-weekly-ranking\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1780630804132\n}\n\nFile v1.0.5:references/core_workflow.md\n\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- **数据范围**：往前7天的热门笔记TOP50\r\n- **分类覆盖**：25个垂直领域分类\r\n\r\n## 调用 Key 说明\r\n\r\nAgent 调用脚本时必须按以下参数规范执行：\r\n\r\n| 参数 | 适用脚本 | 必填 | 说明 |\r\n|------|----------|------|------|\r\n| `--keyword` | 两者 | 推荐 | 用户输入关键词，用于自动匹配分类 |\r\n| `--category` | 两者 | 否 | 直接指定分类名（25 个分类之一），与 `--keyword` 二选一或配合使用 |\r\n| `--rank_date` | 两者 | 否 | 查询日期，格式 `YYYY-MM-DD`；未指定则按日期判断规则自动推断 |\r\n| `--top_n` | `xhs_weekly_fetcher.py` | 否 | 返回条数，执行时固定传 `50` |\r\n| `--top` | `gen_xhs_html.py` | 否 | HTML 展示条数：首次输出 `20`，用户「查看更多」后传 `50` 或实际数据条数 |\r\n| `--output` | `gen_xhs_html.py` | 否 | HTML 输出文件路径，未指定则使用脚本默认路径 |\r\n| `--list_categories` | `xhs_weekly_fetcher.py` | 否 | 列出所有可用分类（调试时使用） |\r\n\r\n**调用示例**：\r\n\r\n```bash\r\n# 获取榜单数据（固定 top_n=50）\r\npython scripts/xhs_weekly_fetcher.py --keyword \"睫毛膏\" --top_n 50\r\n\r\n# 首次生成 HTML（top=20）\r\npython scripts/gen_xhs_html.py --keyword \"睫毛膏\" --top 20\r\n\r\n# 查看更多后生成完整 HTML（top=50）\r\npython scripts/gen_xhs_html.py --keyword \"睫毛膏\" --top 50\r\n\r\n# 指定日期与分类\r\npython scripts/xhs_weekly_fetcher.py --rank_date \"2026-04-15\" --category \"时尚穿搭\" --top_n 50\r\npython scripts/gen_xhs_html.py --rank_date \"2026-04-15\" --category \"时尚穿搭\" --top 20\r\n```\r\n\r\n## 输出规范（强制执行）\r\n\r\n**数据一致性要求（重要）**：\r\n\r\n- 七日爆款笔记表格与HTML页面数据必须完全一致（相同排序、相同内容）\r\n- 两个脚本使用相同的API接口和排序逻辑（互动数优先，备用计算：点赞+收藏*2+评论*3+分享\\*5）\r\n- 禁止胡乱渲染或使用不同数据源\r\n\r\n**输出内容必须严格包含以下三部分，禁止遗漏或胡乱输出：**\r\n\r\n- **七日爆款笔记（更新时间）**：必须直接输出，禁止折叠\r\n- **七日热门笔记分析**：必须直接输出，禁止折叠\r\n- **功能询问（HTML+订阅）**：必须在分析之后立即输出，禁止跳过\r\n\r\n**输出格式要求（强制执行）**：\r\n\r\n- **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\r\n- **禁止输出文件**：除HTML文件包外，禁止输出任何其他文件（如CSV、JSON、TXT等）\r\n- **HTML文件包必须输出实际文件，禁止只输出文件路径，禁止折叠输出**\r\n\r\n**输出顺序（严格按此顺序执行，禁止混乱输出，禁止遗漏）**：\r\n\r\n1. 🔥 七日爆款笔记（含更新时间）\r\n2. 📊 七日热门笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\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- 标题格式：**🔥 【{分类名称}】七日爆款笔记 （更新时间：YYYY-MM-DD HH:MM:SS）**（标题整体加粗）\r\n- 标题示例：**🔥 【化妆美容】七日爆款笔记 （更新时间：2025-01-15 10:30:00）**\r\n\r\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\r\n\r\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\r\n| :--: | :------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\r\n| 🥇 | [笔记标题链接]
[作者名链接] 粉丝数+ | 22w+
↑新增23w+ | 22w+
↑新增21w+ | 893
↑新增21w+ | 1w+
↑新增21w+ | 1w+
↑新增21w+ |\r\n| 🥈 | [笔记标题链接]
[作者名链接] 粉丝数+ | 20w+
↑新增18w+ | 18w+
↑新增16w+ | 756
↑新增18w+ | 8k+
↑新增16w+ | 900+
↑新增16w+ |\r\n| 🥉 | [笔记标题链接]
[作者名链接] 粉丝数+ | 18w+
↑新增15w+ | 15w+
↑新增13w+ | 621
↑新增15w+ | 7k+
↑新增13w+ | 800+
↑新增13w+ |\r\n\r\n**字段详细说明**：\r\n\r\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\r\n- **笔记信息**：\r\n - 第一行：笔记标题（可点击跳转）\r\n - 第二行：[作者名链接] 粉丝数+（作者名可点击跳转到作者主页，字号与标题一样大）\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- 单元格内使用 `
` 换行显示累计数据和新增数据\r\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\r\n- 新增数据格式：累计数据
↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\r\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\r\n- \"↑新增\"文案字号比累计数据小一号\r\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\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- 示例：**📊 七日热门笔记分析（Top50）**\r\n\r\n以下内容分析基于获取的全部数据（Top{数据条数}）进行~\r\n\r\n**💡热门内容分析**\r\n\r\n| 内容分类 | 内容特征 | 实际效果 | 参考笔记 |\r\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\r\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]
[笔记标题链接2] |\r\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望 | 互动率提升50% | [笔记标题链接3]
[笔记标题链接4] |\r\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查 | 收藏率提升55% | [笔记标题链接5]
[笔记标题链接6] |\r\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力 | 曝光率提升40% | [笔记标题链接7]
[笔记标题链接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| 最高点赞 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\r\n| 最高收藏 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\r\n| 最高评论 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\r\n| 最高互动 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\r\n\r\n### 第三部分：功能询问（HTML生成 + 订阅服务）\r\n\r\n**强制要求（必须严格遵守）**：\r\n\r\n- 必须在七日热门笔记分析输出完成后立即展示，不得提前或插入其他内容\r\n- 不需要等待用户回复，分析完成后立即执行\r\n- 用户可选择生成 HTML 文件包、订阅推送或两者都选\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**HTML 生成逻辑**：\r\n\r\n- 用户回复 `2` 或 \"html\" 或 \"生成\" 后，执行 HTML 生成\r\n- HTML 生成时**禁止再次调用 API**，必须从已获取的数据中读取\r\n- 脚本 `xhs_weekly_fetcher.py` 在获取数据后会**自动保存** JSON 到 `scripts/../.cache/xhs_weekly_{分类}_{日期}.json`，并输出保存路径\r\n- Agent 从 fetcher 输出中提取 JSON 文件路径，直接传给 `gen_xhs_html.py --data_file --top N`\r\n- HTML 文件名格式：`小红书七日爆款笔记_{分类}_{唯一时间戳}.html`\r\n\r\n**执行命令**：\r\n\r\n- 首次生成：`python scripts/gen_xhs_html.py --data_file <已获取的JSON数据文件> --category \"{分类}\" --top 20`\r\n- 查看更多后：`python scripts/gen_xhs_html.py --data_file <已获取的JSON数据文件> --category \"{分类}\" --top 50`\r\n\r\n**文件特点**：\r\n\r\n- 可独立打开的HTML文件\r\n- 支持直接点击链接跳转\r\n- 支持导出图片和PDF功能（导出结果与页面显示完全一致）\r\n- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为\"↑新增数值\"格式\r\n- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据）\r\n\r\n**订阅逻辑**：\r\n\r\n- 用户回复 `1` 或 \"订阅\" 后，创建每日 19:30 推送的自动化任务\r\n- 小红书七日爆款笔记推荐TOP50，按每日19:30更新\r\n\r\n## 数据输出逻辑详解\r\n\r\n**核心原则**：\r\n\r\n- 七日爆款笔记表格与HTML页面必须保持数据一致性\r\n- HTML 生成时从已获取的数据文件读取，**禁止再次调用 API**\r\n\r\n### 阶段一：首次输出\r\n\r\n1. **七日爆款笔记表格**：\r\n - 调用脚本获取数据（最多50条），脚本会自动保存 JSON 到 `.cache/` 目录\r\n - Agent 从脚本输出中提取 JSON 缓存路径（`原始数据已保存到: ...`）\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 - 在七日分析完成后立即展示功能询问（HTML生成 + 订阅服务）\r\n - 等待用户回复后再执行对应操作\r\n\r\n3. **HTML生成（用户选择后）**：\r\n - 从第一步自动保存的 JSON 缓存文件读取，**禁止再次调用 API**\r\n - 执行命令：`python scripts/gen_xhs_html.py --data_file <自动缓存的JSON路径> --category \"{分类}\" --top 20`\r\n - 生成 HTML 文件，文件名格式：`小红书七日爆款笔记_{分类}_{时间戳}.html`\r\n - **生成后必须立即调用 `preview_url` 展示页面**，输出文件路径并自动预览；若未正常展示则用 `open_result_view` 兜底\r\n\r\n### 阶段二：用户输入\"查看更多\"\r\n\r\n1. **七日爆款笔记表格**：\r\n - 继续展示TOP21到实际数据末尾（根据实际数据量）\r\n - 延续首次输出的数据，不重复TOP1-20\r\n\r\n2. **HTML重新生成（如用户选择）**：\r\n - 从第一步自动缓存的 JSON 文件读取完整数据\r\n - 执行命令：`python scripts/gen_xhs_html.py --data_file <临时JSON文件> --category \"{分类}\" --top 50`\r\n - 覆盖之前的 HTML 文件\r\n\r\n### 数据一致性保障\r\n\r\n- 两个脚本使用相同的API接口\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**可用分类列表（共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调用脚本获取榜单数据：\r\n\r\n```bash\r\npython scripts/xhs_weekly_fetcher.py --keyword \"睫毛膏\" --top_n 50\r\n```\r\n\r\n参数详见上方「调用 Key 说明」。\r\n\r\n**自动保存 JSON 数据**：脚本获取数据后会自动将原始 JSON 保存到 `.cache/` 目录，并输出保存路径（如 `原始数据已保存到: .../xhs_weekly_化妆美容_2026-05-26.json`）。Agent 需记住此路径，供后续 HTML 生成使用。\r\n\r\n**数据完整性要求**：\r\n\r\n- 确保表格所有字段和数据完整加载\r\n- 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\r\n- 直到所有字段（排名、笔记信息、互动数、点赞、评论、收藏、分享）都有完整数据\r\n- **分享字段使用正确的API字段名**：`AnaAddBean.useShareCount`（累计分享数）、`AnaAddBean.addShareCount`（新增分享数）\r\n- **确保分享数值正确输出，避免使用错误的字段名导致数值不对**\r\n\r\n#### 第五步：输出七日爆款笔记和七日分析\r\n\r\n按照输出规范，依次输出：\r\n\r\n1. 七日爆款笔记（含更新时间）\r\n2. 七日热门笔记分析（3个模块）\r\n\r\n#### 第六步：展示功能询问\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 / \"订阅\"**：\r\n- 创建每日 19:30 推送的自动化任务\r\n- 推送内容：小红书七日爆款笔记推荐TOP50\r\n\r\n**用户回复 2 / \"html\" / \"生成\"**：\r\n- **禁止再次调用 API**，从已获取的数据文件中读取\r\n- 首次生成（TOP20）：`python scripts/gen_xhs_html.py --data_file <临时JSON文件> --category \"{分类}\" --top 20`\r\n- 查看更多后生成（完整数据）：`python scripts/gen_xhs_html.py --data_file <临时JSON文件> --category \"{分类}\" --top 50`\r\n- HTML 文件名格式：`小红书七日爆款笔记_{分类}_{唯一时间戳}.html`\r\n- **HTML 生成后必须立即调用 `preview_url` 直接展示页面**，让用户无需手动查找文件即可浏览报告\r\n\r\n**输出格式**：\r\n\r\nHTML 生成后，Agent 必须执行以下步骤：\r\n1. 优先调用 `preview_url` 工具直接展示 HTML 页面，让用户在对话中即可浏览完整报告\r\n2. 若 `preview_url` 未能正常展示（用户反馈看不到），立即改用 `open_result_view` 兜底展示\r\n3. 同时输出文件路径，方便用户后续查找\r\n\r\n```\r\n📁 HTML文件包已生成 路径：/path/to/小红书七日爆款笔记_综合_20260528160530.html\r\n```\r\n\r\n## 订阅服务说明\r\n\r\n### 订阅内容\r\n\r\n**小红书七日热门笔记推荐TOP50**\r\n\r\n- 每日19:30更新\r\n- 推送往前7天的50篇热门内容\r\n- 包含完整分析和HTML文件\r\n\r\n### 订阅输出格式\r\n\r\n📅 小红书七日热门笔记推荐（2026-04-15 19:30每日更新往前7天的50篇内容）\r\n\r\n**🔥 【综合全部】七日爆款笔记** （更新时间：2026-04-15 19:30:00）\r\n\r\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\r\n| :--: | :------------------------------- | :-------------: | :---------------: | :---------------: | :---------------: | :---------------: |\r\n| 🥇 | [笔记标题链接]
作者名 粉丝数+ | 8w+
↑新增1w+ | 5w+
↑新增5000+ | 2w+
↑新增2000+ | 1w+
↑新增1000+ | 800+
↑新增500+ |\r\n\r\n回复\"查看更多\"可看剩余30条！✨\r\n\r\n**📊 七日热门笔记分析（Top50）**\r\n\r\n以下内容分析基于获取的全部数据（Top50）进行~\r\n\r\n**💡热门内容分析**\r\n\r\n| 内容分类 | 内容特征 | 实际效果 | 参考笔记 |\r\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\r\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]
[笔记标题链接2] |\r\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望 | 互动率提升50% | [笔记标题链接3]
[笔记标题链接4] |\r\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查 | 收藏率提升55% | [笔记标题链接5]
[笔记标题链接6] |\r\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力 | 曝光率提升40% | [笔记标题链接7]
[笔记标题链接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| 最高点赞 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\r\n| 最高收藏 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\r\n| 最高评论 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\r\n| 最高互动 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\r\n\r\n**📁 HTML文件包**\r\n\r\n```\r\n\r\n**订阅服务（是否需要订阅小红书七日热门笔记推荐？）**\r\n1. 每日19:30-推送小红书七日热门笔记TOP50\r\n2. 暂不需要-仅本次查询\r\n\r\n请回复数字或\"取消\"。\r\n\r\n## 使用示例\r\n\r\n### 示例1：关键词查询（数据=50条）\r\n- **场景/输入**：\"帮我查一下睫毛膏相关的爆款笔记\"\r\n- **执行流程**：\r\n 1. 匹配分类：睫毛膏 → 化妆美容\r\n 2. 查询化妆美容分类，返回50条数据，保存JSON到临时文件\r\n 3. 七日爆款笔记表格展示TOP1-20\r\n 4. 展示\"回复\"查看更多\"可看剩余30条！✨\"提示\r\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\r\n 6. **展示功能询问**（HTML生成 + 订阅服务）\r\n 7. 用户选择后执行对应操作（HTML从临时JSON文件读取，不再调用API）\r\n\r\n### 示例2：泛查询热门内容（数据=30条）\r\n- **场景/输入**：\"最近小红书有什么热门内容\"\r\n- **执行流程**：\r\n 1. 使用\"综合全部\"分类\r\n 2. 查询后返回30条数据，保存JSON到临时文件\r\n 3. 七日爆款笔记表格展示TOP1-20\r\n 4. 展示\"回复\"查看更多\"可看剩余10条！✨\"提示\r\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\r\n 6. **展示功能询问**（HTML生成 + 订阅服务）\r\n\r\n### 示例3：数据不足20条（数据=15条）\r\n- **场景/输入**：\"查询某个冷门分类\"\r\n- **执行流程**：\r\n 1. 匹配对应分类\r\n 2. 查询后返回15条数据，保存JSON到临时文件\r\n 3. 七日爆款笔记表格展示TOP1-15（全部数据）\r\n 4. 不展示\"查看更多\"提示（数据未超过20条）\r\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\r\n 6. **展示功能询问**（HTML生成 + 订阅服务）\r\n\r\n### 示例4：查看更多内容\r\n- **场景/输入**：用户回复\"查看更多\"\r\n- **执行流程**：\r\n 1. 七日爆款笔记表格展示TOP21-实际数据末尾（延续之前的数据）\r\n 2. 如用户选择生成HTML，从临时JSON文件读取完整数据重新生成\r\n\r\n## 资源索引\r\n- **脚本**：见 [scripts/xhs_weekly_fetcher.py](scripts/xhs_weekly_fetcher.py)\r\n - 用途：获取小红书七日爆款笔记数据\r\n - 参数：详见上方「调用 Key 说明」\r\n- **脚本**：见 [scripts/gen_xhs_html.py](scripts/gen_xhs_html.py)\r\n - 用途：生成可视化HTML页面\r\n - 参数：详见上方「调用 Key 说明」\r\n\r\n## 注意事项\r\n- 数据每日19:00更新昨天的榜单\r\n- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含七日爆款笔记（更新时间）+ 七日热门笔记分析 + 功能询问\r\n - 🔥 七日爆款笔记（必须包含更新时间）\r\n - 📊 七日热门笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\r\n - 功能询问（HTML生成 + 订阅服务，分析完成后立即展示）\r\n - **禁止输出遗漏，禁止胡乱输出，必须严格按照此3项内容输出**\r\n- **输出格式要求（强制）**：\r\n - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\r\n - **禁止输出文件**：除HTML文件包外，禁止输出任何其他文件（如CSV、JSON、TXT等）\r\n - **输出顺序**：严格按照七日爆款笔记 → 七日分析 → HTML文件包 → 订阅服务的顺序执行，禁止混乱输出\r\n- **输出顺序（严格按此顺序执行，禁止混乱输出）**：\r\n 1. **🔥 七日爆款笔记**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）\r\n 2. **📊 七日热门笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）\r\n 3. **功能询问**（必须在分析之后展示，提供HTML生成和订阅推送选项）\r\n- **HTML文件包输出要求（强制）**：\r\n - 必须在用户选择生成后才执行，不得自动生成\r\n - **禁止再次调用 API**，必须从已获取的数据文件中读取\r\n - HTML 文件名格式：`小红书七日爆款笔记_{分类}_{唯一时间戳}.html`\r\n - **生成后必须立即调用 `preview_url` 在对话中直接展示页面**，禁止只输出文件路径\r\n - **若 `preview_url` 未正常展示（含中文路径等兼容问题），立即改用 `open_result_view` 兜底**\r\n - **PDF和图片导出内容一定是正确的**\r\n- **功能询问输出要求（强制，必须执行）**：\r\n - 必须在七日分析输出完成后立即展示\r\n - **禁止跳过，禁止遗漏，禁止等待用户回复**\r\n - 提供两个选项：订阅推送 或 生成HTML文件包\r\n - 用户可回复数字或关键词选择对应功能\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- 七日分析标题后显示\"以下内容分析基于获取的全部数据（Top{数据条数}）进行~\"\r\n- 分析内容从创作者视角出发，提供可执行建议\n\nFile v1.0.5:README.en.md\n\n# Xiaohongshu Weekly Viral Notes / xiaohongshu-weeklytop\r\n\r\n---\r\n\r\n## Introduction\r\n\r\nA Xiaohongshu 7-day viral notes tool designed for creators and operators — one query delivers vertical category hot rankings and deep analysis based on the TOP50 notes from the past 7 days.\r\n\r\n**Core Value**\r\n\r\n- Solves the \"I don't know what's trending or why\" problem in topic selection — a 7-day window is more stable and reliable than a single day\r\n- Real-time hot rankings + smart analysis + exportable HTML reports, supporting review sessions and creative decisions\r\n- Keyword auto-matching across 25 vertical categories lowers the barrier to query\r\n\r\n**Who It's For**\r\n\r\n- ✍️ Xiaohongshu creators — understand what content tends to go viral in your track over the past week, and find replicable topic directions\r\n- 📢 Brand marketing managers — monitor vertical category viral content trends to optimize placements and seeding strategies\r\n- 🏢 MCN operations staff — provide track hot topic references for managed creators to shorten topic discussion cycles\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Recent hot rankings**: Query the past 7 days' hot notes by category, covering 25 vertical tracks to quickly grasp current traffic direction\r\n- **7-day trend analysis**: Deep insights from multiple dimensions — popular trends, hot topics, practical value — breaking down viral content commonalities\r\n- **Format pattern comparison**: Auto-identifies viral elements like high-quality covers, emotional resonance, practical value, and trend alignment\r\n- **Creative suggestions**: Delivers actionable topic directions, differentiation strategies, and high-performing post breakdowns\r\n- **Subscription push**: Daily 19:30 scheduled delivery of the latest trend analysis reports\r\n\r\n### Highlights\r\n\r\n- Hot ranking tables and HTML pages share the same data source and sort logic — rankings are fully consistent\r\n- First display shows TOP20; reply \"load more\" to get remaining data, HTML updates to full version\r\n- Focused on low-follower high-engagement notes, ideal for finding authentic benchmark viral samples\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 track 7-day hot rankings | `Show me viral notes related to mascara` | Auto-matches \"Beauty & Makeup\", outputs TOP20 hot rankings + 7-day analysis + HTML + subscription option |\r\n| Query general hot content | `What's trending on Xiaohongshu lately?` | Uses \"All\" category, full four-section standard output |\r\n| Query specific date | `Show fashion track hot rankings for 2026-04-15` | Fetches data for the specified date |\r\n| Load more | Reply \"load more\" | Continues output from TOP21 to end; HTML regenerated as full version |\r\n| Subscribe to daily push | Reply `1` after output completes | Activates daily 19:30 7-day viral notes push |\r\n\r\n### Output Example\r\n\r\nEach query produces four fixed sections: recent hot rankings TOP20 → 7-day viral analysis (trends + topics + format patterns) → 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| Creator topic inspiration | New Xiaohongshu creator | `Show 7-day hot rankings in skincare` | Quickly find replicable topic directions to lower cold-start trial-and-error costs |\r\n| Brand competitor monitoring | Brand marketing manager | `Query lipstick 7-day virals and export HTML` | Grasp category content direction to optimize placement and seeding strategies |\r\n| Creator operations review | MCN ops staff | `Query fashion 7-day rankings and subscribe to push` | Break down viral title types and continuously track hot topics for creator topic planning |\r\n| Data insights reporting | Growth / data analyst | `Fetch full food TOP50 and export HTML` | Get a shareable, archivable data report to support weekly reviews and strategy sessions |\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\nThis skill helps Xiaohongshu creators and operators fetch and analyze top 7-day viral notes across 25 content categories, with optional HTML reporting and daily subscription prompts.\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 marketers, MCN operators, and growth analysts use this skill to monitor Xiaohongshu 7-day viral-note rankings, compare content patterns, generate Markdown analysis, and optionally produce shareable HTML reports.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill requires access to a RedFox API key.\n\nMitigation: Set REDFOX_API_KEY only in the current session or a proper secret store, and do not print, hard-code, or log the full key.\n\nRisk: The skill contacts redfox.hk to fetch Xiaohongshu ranking data.\n\nMitigation: Install and run it only in environments where outbound access to redfox.hk is expected and permitted.\n\nRisk: Fetched API responses and generated HTML reports are written locally.\n\nMitigation: Review and delete .cache data and generated reports when they are no longer needed.\n\nRisk: Generated HTML reports may include untrusted API data and remote script dependencies.\n\nMitigation: Avoid opening generated HTML from untrusted or unreviewed data until the escaping and remote-script issues are fixed.\n\nRisk: Daily subscription behavior may create persistent automation.\n\nMitigation: Confirm how to cancel or disable the daily subscription before enabling it.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/if530770/skills/xhs-weekly-ranking)\n- [Core Workflow](references/core_workflow.md)\n- [RedFoxHub API Keys](https://redfox.hk/settings/api-keys?source=clawhub)\n- [RedFoxHub](https://redfox.hk)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, HTML files, guidance]\n\n**Output Format:** [Markdown tables and analysis, shell commands, configuration guidance, and optional standalone HTML report files.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires REDFOX_API_KEY and network access to redfox.hk; fetched API data is cached locally for report generation.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.4: 9 files, 47963 bytes\n\nFiles: README.en.md (5711b), README.md (4612b), references/core_workflow.md (33343b), scripts/gen_xhs_html.py (21102b), scripts/xhs_weekly_fetcher.py (29030b), scripts/xhs_weekly.html (38663b), skill-card.md (2416b), SKILL.md (12196b), _meta.json (137b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: xiaohongshu-weeklytop\ndescription: 专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送。创作者可查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感。\n---\n\n# 小红书七日爆款笔记\n\n## 简介\n\n**一句话定位**：专为内容创作者与运营人员设计的小红书七日爆款笔记工具，一键获取垂直领域热门笔记与深度分析。\n\n**核心价值**：\n- 解决「不知道当下什么内容火、为什么火」的选题难题\n- 提供七日爆款笔记 + 智能分析 + 可选 HTML 报告，支撑复盘与创作决策\n- 支持关键词自动匹配 25 个垂直分类，降低查询门槛\n\n**适用对象**：品牌方、MCN 机构、小红书博主、内容运营、增长团队\n\n**技术基础**：Python 3 + RedFox 小红书数据 API，数据每日 19:00 更新\n\n---\n\n## 功能特性\n\n### 🎯 核心功能\n\n| 功能 | 说明 |\n|------|------|\n| 📊 近日热榜查询 |按分类查询热门笔记，覆盖美妆、穿搭、美食、家居等25个垂直领域，快速掌握当下流量风向 |\n| 📈 七日热门分析 | 基于近7天各分类TOP50热门笔记的深度洞察，从流行趋势、热门话题深度分析、实用价值等维度拆解爆款共性 |\n| 🔍 形式规律对比 | 自动识别高质量封面、情绪共鸣点、实用价值、紧跟热点等爆款要素，提炼可复用的创作范式 |\n| 📁 创作建议输出 | 基于分析结果，提供可执行的选题方向、差异化策略、高维作品拆解建议 |\n| 🔔 订阅推送 | 定时推送最新趋势分析报告，持续跟踪赛道热点，不错过任何一个流量机会 |\n\n### ✨ 特色亮点\n\n- **⚡ 数据一致**：七日爆款笔记表格与 HTML 页面使用相同数据源与排序逻辑，排名完全一致\n- **📱 分页展示**：首次展示 TOP20，回复「查看更多」可加载剩余数据\n- **🎯 冷门爆款**：聚焦低粉高互动笔记，适合挖掘可对标样本\n- **🔒 零配置调用**：Agent 执行时自动判断查询日期，无需手动维护\n\n---\n\n## 鉴权\n\n### 获取 API Key\n\n1. 访问 [红狐Hub 官网](https://redfox.hk/) 了解服务详情\n2. 前往 [注册页面](https://redfox.hk/login) 注册账号\n3. 新注册用户将获赠免费积分，可立即开始使用 API 服务\n4. 注册登录后，在个人中心获取 API Key，格式为 `ak_xxxxxxxx`\n\n### 配置 API Key\n\n`REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`。\n\n若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若不会配置，Agent 可主动帮用户设置：\n\n- **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效\n- **Windows**：使用 `[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<值>\", \"User\")` 设置用户级永久环境变量（需重启终端生效）\n\n配置完成后应验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确保换一个 skill 也能读取到。\n\n---\n\n## 一键安装\n\n### 前置条件\n\n- Python 3.8+\n- 网络可访问 `redfox.hk` 数据 API\n- 已安装 `requests` 库（`pip install requests`）\n- 已配置 `REDFOX_API_KEY` 环境变量（参见上方「鉴权」章节）\n\n### 安装方式\n\n#### 方式一：WorkBuddy / Cursor Skills（推荐）\n\n1. 将本 Skill 目录放置于 Skills 工作区（如 `~/.workbuddy/skills/xiaohongshu-weeklytop`）\n2. 确保目录结构完整：`SKILL.md`、`references/`、`scripts/`\n3. 在对话中直接触发，例如：\n - 「帮我查一下睫毛膏相关的爆款笔记」\n - 「最近小红书有什么热门内容」\n - 「查看穿搭领域七日热榜」\n\n#### 方式二：命令行独立运行\n\n```bash\n# 进入 Skill 目录\ncd xiaohongshu-weeklytop\n\n# 获取榜单数据（JSON 输出）\npython scripts/xhs_weekly_fetcher.py --keyword \"睫毛膏\" --top_n 50\n\n# 生成 HTML 报告（从已获取的数据文件读取，不再调用API）\npython scripts/gen_xhs_html.py --data_file \"xhs_data.json\" --category \"化妆美容\" --top 20\n```\n\n---\n\n## 使用指南\n\n> **执行约束（强制）**：Agent 执行本 Skill 时，**必须先完整阅读并严格遵循** [references/core_workflow.md](references/core_workflow.md) 中的调用 Key 说明、输出规范、操作步骤与注意事项。以下为基础用法摘要，详细流程以核心工作流文档为准。\n\n### 基础使用\n\n#### 1. 关键词查询爆款\n\n> **用户**：帮我查一下睫毛膏相关的爆款笔记\n>\n> **助手**：自动匹配「化妆美容」分类 → 获取 TOP50 数据 → 输出七日爆款笔记 TOP20 → 七日分析 → 功能询问（HTML+订阅）\n\n#### 2. 泛领域热门查询\n\n> **用户**：最近小红书有什么热门内容\n>\n> **助手**：使用「综合全部」分类 → 按标准三步输出完整结果\n\n#### 3. 查看更多数据\n\n> **用户**：查看更多\n>\n> **助手**：延续输出 TOP21 至末尾 → 如用户选择生成 HTML，从已获取数据文件读取完整数据重新生成\n\n### 高级使用\n\n#### 1. 指定日期查询\n\n> **用户**：查看 2026-04-15 穿搭领域热榜\n>\n> **助手**：使用 `--rank_date \"2026-04-15\"` 查询指定日期数据\n\n#### 2. 直接指定分类\n\n```bash\npython scripts/xhs_weekly_fetcher.py --category \"时尚穿搭\" --top_n 50\npython scripts/gen_xhs_html.py --category \"时尚穿搭\" --top 50\n```\n\n#### 3. 订阅每日推送 / 生成 HTML\n\n首次查询完成后，助手会展示功能询问：回复 `1` 订阅每日 19:30 推送，回复 `2` 生成小红书风格 HTML 文件包。HTML 生成后会自动在对话中预览展示（优先 `preview_url`，未正常展示则用 `open_result_view` 兜底），无需手动查找文件。\n\n#### 4. 自定义 HTML 输出路径\n\n```bash\npython scripts/gen_xhs_html.py --data_file \"xhs_data.json\" --category \"穿搭\" --top 20 --output ./reports/小红书七日爆款笔记_穿搭.html\n```\n\n### 常用命令速查\n\n| 命令 / 场景 | 功能 |\n|-------------|------|\n| `python scripts/xhs_weekly_fetcher.py --keyword \"{词}\" --top_n 50` | 获取榜单原始数据 |\n| `python scripts/gen_xhs_html.py --data_file \"{文件}\" --category \"{分类}\" --top 20` | 首次生成 HTML（TOP20，从数据文件读取） |\n| `python scripts/gen_xhs_html.py --data_file \"{文件}\" --category \"{分类}\" --top 50` | 查看更多后生成完整 HTML |\n| 用户说「查看更多」 | 输出 TOP21+ |\n| 用户回复 `1` / \"订阅\" | 订阅每日 19:30 推送 |\n| 用户回复 `2` / \"html\" / \"生成\" | 生成 HTML 文件包 |\n\n### 核心工作流引用\n\n完整执行规范（输出格式、调用 Key、表格字段、数据一致性、订阅逻辑、使用示例等）见：\n\n**→ [references/core_workflow.md](references/core_workflow.md)**\n\n---\n\n## 使用场景\n\n### 场景一：博主选题灵感\n\n**角色**：小红书新人博主\n\n**需求**：了解同赛道当下什么内容容易爆\n\n**使用方式**：\n1. 输入赛道关键词（如「护肤」「穿搭」）\n2. 查看七日爆款笔记 TOP20 与七日分析\n3. 对标参考笔记的标题结构与内容特征\n\n**预期收益**：快速找到可借鉴的选题方向，降低冷启动试错成本\n\n---\n\n### 场景二：品牌竞品监测\n\n**角色**：品牌营销经理\n\n**需求**：监测垂直领域爆款内容与趋势变化\n\n**使用方式**：\n1. 按产品/品类关键词查询（如「口红」「防晒」）\n2. 分析最高互动作品的共性特征\n3. 导出 HTML 报告供团队复盘\n\n**预期收益**：掌握品类内容风向，优化投放与种草策略\n\n---\n\n### 场景三：MCN 达人运营复盘\n\n**角色**：MCN 运营人员\n\n**需求**：为旗下达人提供赛道热点参考\n\n**使用方式**：\n1. 按达人赛道查询七日热榜\n2. 拆解爆款标题类型与发布规律\n3. 订阅每日推送，持续跟踪热点\n\n**预期收益**：提升达人内容策划效率，缩短选题讨论周期\n\n---\n\n### 场景四：增长团队数据洞察\n\n**角色**：增长/数据分析同学\n\n**需求**：获取可导出的结构化热榜报告\n\n**使用方式**：\n1. 查询目标分类完整 TOP50\n2. 使用 HTML 页面导出 PDF/图片\n3. 结合新增互动数据判断内容上升势头\n\n**预期收益**：获得可分享、可归档的数据报告，支撑周报与策略会\n\n---\n\n## 项目架构\n\n### 目录结构\n\n```\nxiaohongshu-weeklytop/\n├── SKILL.md # Skill 入口与使用说明（本文件）\n├── references/\n│ └── core_workflow.md # 核心执行流程与输出规范（Agent 必读）\n└── scripts/\n ├── xhs_weekly_fetcher.py # 榜单数据获取脚本\n └── gen_xhs_html.py # HTML 可视化报告生成脚本\n```\n\n### 技术栈\n\n| 项目 | 说明 |\n|------|------|\n| 运行环境 | Python 3.8+ |\n| HTTP 请求 | `requests`（原生 Python） |\n| 数据来源 | RedFox 小红书 Coze Skill API |\n| 输出格式 | Markdown 表格 + 独立 HTML 文件 |\n| 部署平台 | WorkBuddy / Cursor Agent Skills |\n\n### 核心模块\n\n| 模块 | 文件 | 职责 |\n|------|------|------|\n| 数据获取 | `xhs_weekly_fetcher.py` | 调用 API、分类匹配、日期判断、排序输出 |\n| 报告生成 | `gen_xhs_html.py` | 从已获取的 JSON 数据文件渲染 HTML 页面，支持 PDF/图片导出 |\n| 执行规范 | `core_workflow.md` | 定义输出格式、调用 Key、三步流程、功能询问等强制约束 |\n\n\n\n### 数据更新规则\n\n- **更新时间**：每天 19:00 更新昨日榜单\n- **数据范围**：往前 7 天热门笔记 TOP50\n- **分类覆盖**：25 个垂直领域\n- **日期判断**：当前时间 ≥ 19:00 查昨日，< 19:00 查前天\n\n---\n\n## 常见问答\n\n### 安装相关问题\n\n**Q1: 脚本运行报错 `ModuleNotFoundError: requests`？**\n\nA: 该依赖为标准 Python HTTP 库。请运行 `pip install requests` 安装。若在虚拟环境中运行，请确保已激活对应环境。\n\n**Q2: 脚本提示「未找到 REDFOX_API_KEY」？**\n\nA: 请按照上方「鉴权」章节完成 API Key 的获取和配置。确保环境变量 `REDFOX_API_KEY` 已正确设置且格式为 `ak_xxxxxxxx`。\n\n**Q3: 如何将 Skill 添加到 Cursor / WorkBuddy？**\n\nA: 将 `xiaohongshu-weeklytop` 文件夹放入 Skills 目录，Agent 会根据 `description` 自动匹配触发。对话中提及「小红书热门」「爆款笔记」等关键词即可调用。\n\n---\n\n### 使用相关问题\n\n**Q4: 数据多久更新一次？**\n\nA: 榜单数据每日 19:00 更新（更新的是昨日数据）。订阅推送时间为每日 19:30。\n\n**Q5: 为什么有时查的是「前天」而不是「昨天」？**\n\nA: 当日 19:00 之前，最新榜单尚未更新，系统自动查询前天数据。19:00 之后则查询昨日数据。详见 [core_workflow.md](references/core_workflow.md) 日期判断规则。\n\n\n---\n\n### 故障排除\n\n**Q6: 七日爆款笔记表格与 HTML 数据不一致？**\n\nA: HTML 生成时从已获取的 JSON 数据文件读取，与表格使用完全相同的原始数据。检查是否使用了不同的 `--top` 参数。\n\n**Q7: API 请求失败或无数据？**\n\nA: 按以下步骤排查：\n1. 确认网络可访问 [红狐Hub 官网](https://redfox.hk/)\n2. 检查 `--rank_date` 是否为有效日期\n3. 尝试更换关键词或指定 `--category`\n4. 19:00 前查询时，确认是否应使用前天日期\n\n---\n\n### 执行规范\n\n**Q8: Agent 执行时必须遵守哪些规则？**\n\nA: 必须完整遵循 [references/core_workflow.md](references/core_workflow.md)，包括但不限于：\n- 调用 Key 说明（脚本参数与 top_n/top 取值规范）\n- 三步输出顺序（七日爆款笔记 → 分析 → 功能询问）\n- 禁止折叠输出、禁止输出除 HTML 外的文件\n- 首次 TOP20 + 查看更多逻辑\n- HTML 生成时从已获取数据文件读取，禁止再次调用 API\n- HTML 生成后必须调用 preview_url 在对话中直接展示页面；若未正常展示则用 open_result_view 兜底\n- 功能询问在分析之后立即展示，禁止跳过\n\nFile v1.0.4:README.md\n\n# 小红书七日爆款笔记 / xiaohongshu-weeklytop\r\n\r\n---\r\n\r\n## 简介\r\n\r\n专为内容创作者与运营人员设计的小红书七日爆款笔记工具，基于近 7 天热门笔记 TOP50 深度洞察，一键获取垂直领域热榜与创作分析。\r\n\r\n**核心价值**\r\n\r\n- 解决「不知道当下什么内容火、为什么火」的选题难题，7 天维度比单日更稳定可信\r\n- 实时热榜 + 智能分析 + 可导出 HTML 报告，支撑复盘与创作决策\r\n- 支持关键词自动匹配 25 个垂直分类，降低查询门槛\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- **近日热榜查询**：按分类查询近 7 天热门笔记，覆盖 25 个垂直领域，快速掌握当下流量风向\r\n- **七日热门分析**：从流行趋势、热门话题、实用价值等维度深度拆解爆款共性\r\n- **形式规律对比**：自动识别高质量封面、情绪共鸣点、实用价值、紧跟热点等爆款要素\r\n- **创作建议输出**：提供可执行的选题方向、差异化策略与高维作品拆解建议\r\n- **订阅推送**：每日 19:30 定时推送最新趋势分析报告\r\n\r\n### 特色亮点\r\n\r\n- 热榜表格与 HTML 页面使用相同数据源与排序逻辑，排名完全一致\r\n- 首次展示 TOP20，回复「查看更多」可加载剩余数据，HTML 同步更新为全量\r\n- 聚焦低粉高互动笔记，适合挖掘可对标的真实爆款样本\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=github) (`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-15 穿搭领域热榜` | 指定日期获取对应数据 |\r\n| 加载更多 | 回复「查看更多」 | 延续输出 TOP21 至末尾，HTML 重新生成为完整版本 |\r\n| 订阅每日推送 | 输出完成后回复 `1` | 开通每日 19:30 七日爆款笔记推送 |\r\n\r\n### 输出示例\r\n\r\n每次查询固定四段输出：近日热榜 TOP20 → 七日爆款分析（趋势 + 话题 + 形式规律）→ HTML 可视化页面 → 订阅服务选项。\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景 | 角色 | 示例问法 | 收益 |\r\n| ------------ | --------------- | --------------------------------- | ------------------------------------------------ |\r\n| 博主选题灵感 | 小红书新人博主 | `查一下护肤领域七日热榜` | 快速找到可借鉴的选题方向，降低冷启动试错成本 |\r\n| 品牌竞品监测 | 品牌营销经理 | `查口红相关的七日爆款并导出 HTML` | 掌握品类内容风向，优化投放与种草策略 |\r\n| 达人运营复盘 | MCN 运营人员 | `查穿搭领域七日热榜并订阅推送` | 拆解爆款标题类型，持续跟踪热点为达人提供选题参考 |\r\n| 数据洞察汇报 | 增长 / 数据分析 | `查美食类完整 TOP50 并导出 HTML` | 获得可分享、可归档的数据报告，支撑周报与策略会 |\n\nFile v1.0.4:_meta.json\n\n{\n \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n \"slug\": \"xhs-weekly-ranking\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1780630740530\n}\n\nFile v1.0.4:references/core_workflow.md\n\n## 任务目标\n\n- 本 Skill 用于：获取小红书七日爆款笔记数据\n- 能力包含：\n - 七日爆款笔记数据获取（按分类查询）\n - 七日热门笔记智能分析\n - 冷门爆款笔记挖掘（关键词匹配分类）\n - 订阅服务（每日定时推送）\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\n\n## 数据接口更新规则\n\n- **更新时间**：每天19:00更新昨天的榜单数据\n- **数据范围**：往前7天的热门笔记TOP50\n- **分类覆盖**：25个垂直领域分类\n\n## 调用 Key 说明\n\nAgent 调用脚本时必须按以下参数规范执行：\n\n| 参数 | 适用脚本 | 必填 | 说明 |\n|------|----------|------|------|\n| `--keyword` | 两者 | 推荐 | 用户输入关键词，用于自动匹配分类 |\n| `--category` | 两者 | 否 | 直接指定分类名（25 个分类之一），与 `--keyword` 二选一或配合使用 |\n| `--rank_date` | 两者 | 否 | 查询日期，格式 `YYYY-MM-DD`；未指定则按日期判断规则自动推断 |\n| `--top_n` | `xhs_weekly_fetcher.py` | 否 | 返回条数，执行时固定传 `50` |\n| `--top` | `gen_xhs_html.py` | 否 | HTML 展示条数：首次输出 `20`，用户「查看更多」后传 `50` 或实际数据条数 |\n| `--output` | `gen_xhs_html.py` | 否 | HTML 输出文件路径，未指定则使用脚本默认路径 |\n| `--list_categories` | `xhs_weekly_fetcher.py` | 否 | 列出所有可用分类（调试时使用） |\n\n**调用示例**：\n\n```bash\n# 获取榜单数据（固定 top_n=50）\npython scripts/xhs_weekly_fetcher.py --keyword \"睫毛膏\" --top_n 50\n\n# 首次生成 HTML（top=20）\npython scripts/gen_xhs_html.py --keyword \"睫毛膏\" --top 20\n\n# 查看更多后生成完整 HTML（top=50）\npython scripts/gen_xhs_html.py --keyword \"睫毛膏\" --top 50\n\n# 指定日期与分类\npython scripts/xhs_weekly_fetcher.py --rank_date \"2026-04-15\" --category \"时尚穿搭\" --top_n 50\npython scripts/gen_xhs_html.py --rank_date \"2026-04-15\" --category \"时尚穿搭\" --top 20\n```\n\n## 输出规范（强制执行）\n\n**数据一致性要求（重要）**：\n\n- 七日爆款笔记表格与HTML页面数据必须完全一致（相同排序、相同内容）\n- 两个脚本使用相同的API接口和排序逻辑（互动数优先，备用计算：点赞+收藏*2+评论*3+分享\\*5）\n- 禁止胡乱渲染或使用不同数据源\n\n**输出内容必须严格包含以下三部分，禁止遗漏或胡乱输出：**\n\n- **七日爆款笔记（更新时间）**：必须直接输出，禁止折叠\n- **七日热门笔记分析**：必须直接输出，禁止折叠\n- **功能询问（HTML+订阅）**：必须在分析之后立即输出，禁止跳过\n\n**输出格式要求（强制执行）**：\n\n- **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n- **禁止输出文件**：除HTML文件包外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n- **HTML文件包必须输出实际文件，禁止只输出文件路径，禁止折叠输出**\n\n**输出顺序（严格按此顺序执行，禁止混乱输出，禁止遗漏）**：\n\n1. 🔥 七日爆款笔记（含更新时间）\n2. 📊 七日热门笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n3. 功能询问（HTML生成 + 订阅服务，分析完成后立即展示，禁止等待用户回复）\n\n### 第一部分：七日爆款笔记（必须包含更新时间）\n\n**输出要求**：\n\n- 必须直接完整输出表格内容\n- 禁止折叠、隐藏或展开表格\n- 禁止输出为文件格式\n- **表格字段和数据必须加载完整，加载失败则再次尝试**\n\n- 标题格式：**🔥 【{分类名称}】七日爆款笔记 （更新时间：YYYY-MM-DD HH:MM:SS）**（标题整体加粗）\n- 标题示例：**🔥 【化妆美容】七日爆款笔记 （更新时间：2025-01-15 10:30:00）**\n\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\n\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\n| :--: | :------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\n| 🥇 | [笔记标题链接]
[作者名链接] 粉丝数+ | 22w+
↑新增23w+ | 22w+
↑新增21w+ | 893
↑新增21w+ | 1w+
↑新增21w+ | 1w+
↑新增21w+ |\n| 🥈 | [笔记标题链接]
[作者名链接] 粉丝数+ | 20w+
↑新增18w+ | 18w+
↑新增16w+ | 756
↑新增18w+ | 8k+
↑新增16w+ | 900+
↑新增16w+ |\n| 🥉 | [笔记标题链接]
[作者名链接] 粉丝数+ | 18w+
↑新增15w+ | 15w+
↑新增13w+ | 621
↑新增15w+ | 7k+
↑新增13w+ | 800+
↑新增13w+ |\n\n**字段详细说明**：\n\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\n- **笔记信息**：\n - 第一行：笔记标题（可点击跳转）\n - 第二行：[作者名链接] 粉丝数+（作者名可点击跳转到作者主页，字号与标题一样大）\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- 单元格内使用 `
` 换行显示累计数据和新增数据\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\n- 新增数据格式：累计数据
↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\n- \"↑新增\"文案字号比累计数据小一号\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\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- 示例：**📊 七日热门笔记分析（Top50）**\n\n以下内容分析基于获取的全部数据（Top{数据条数}）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征 | 实际效果 | 参考笔记 |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]
[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望 | 互动率提升50% | [笔记标题链接3]
[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查 | 收藏率提升55% | [笔记标题链接5]
[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力 | 曝光率提升40% | [笔记标题链接7]
[笔记标题链接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| 最高点赞 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n\n### 第三部分：功能询问（HTML生成 + 订阅服务）\n\n**强制要求（必须严格遵守）**：\n\n- 必须在七日热门笔记分析输出完成后立即展示，不得提前或插入其他内容\n- 不需要等待用户回复，分析完成后立即执行\n- 用户可选择生成 HTML 文件包、订阅推送或两者都选\n- **禁止跳过，禁止遗漏**\n\n**询问内容**：\n\n```\n技能还支持以下功能：\n1️⃣ 支持订阅小红书七日爆款笔记。订阅后将在每日19:30为您推送小红书七日爆款笔记TOP50。直接回复\"订阅或 1\"即可订阅相关内容。\n2️⃣ 可生成小红书风格的html文件包。支持导出PDF，方便阅读、保存和分享。\n```\n\n回复对应的数字即可。\n\n**HTML 生成逻辑**：\n\n- 用户回复 `2` 或 \"html\" 或 \"生成\" 后，执行 HTML 生成\n- HTML 生成时**禁止再次调用 API**，必须从已获取的数据中读取\n- 脚本 `xhs_weekly_fetcher.py` 在获取数据后会**自动保存** JSON 到 `scripts/../.cache/xhs_weekly_{分类}_{日期}.json`，并输出保存路径\n- Agent 从 fetcher 输出中提取 JSON 文件路径，直接传给 `gen_xhs_html.py --data_file --top N`\n- HTML 文件名格式：`小红书七日爆款笔记_{分类}_{唯一时间戳}.html`\n\n**执行命令**：\n\n- 首次生成：`python scripts/gen_xhs_html.py --data_file <已获取的JSON数据文件> --category \"{分类}\" --top 20`\n- 查看更多后：`python scripts/gen_xhs_html.py --data_file <已获取的JSON数据文件> --category \"{分类}\" --top 50`\n\n**文件特点**：\n\n- 可独立打开的HTML文件\n- 支持直接点击链接跳转\n- 支持导出图片和PDF功能（导出结果与页面显示完全一致）\n- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为\"↑新增数值\"格式\n- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据）\n\n**订阅逻辑**：\n\n- 用户回复 `1` 或 \"订阅\" 后，创建每日 19:30 推送的自动化任务\n- 小红书七日爆款笔记推荐TOP50，按每日19:30更新\n\n## 数据输出逻辑详解\n\n**核心原则**：\n\n- 七日爆款笔记表格与HTML页面必须保持数据一致性\n- HTML 生成时从已获取的数据文件读取，**禁止再次调用 API**\n\n### 阶段一：首次输出\n\n1. **七日爆款笔记表格**：\n - 调用脚本获取数据（最多50条），脚本会自动保存 JSON 到 `.cache/` 目录\n - Agent 从脚本输出中提取 JSON 缓存路径（`原始数据已保存到: ...`）\n - 展示TOP1到TOP20（前20条）\n - **\"查看更多\"提示逻辑（根据实际数据量动态调整）**：\n - 如果返回数据 ≤ 20条：不展示\"查看更多\"提示\n - 如果返回数据 > 20条且 < 50条：展示\"回复\"查看更多\"可看剩余{实际剩余数量}条！✨\"\n - 如果返回数据 = 50条：展示\"回复\"查看更多\"可看剩余30条！✨\"（固定30条）\n\n2. **功能询问**：\n - 在七日分析完成后立即展示功能询问（HTML生成 + 订阅服务）\n - 等待用户回复后再执行对应操作\n\n3. **HTML生成（用户选择后）**：\n - 从第一步自动保存的 JSON 缓存文件读取，**禁止再次调用 API**\n - 执行命令：`python scripts/gen_xhs_html.py --data_file <自动缓存的JSON路径> --category \"{分类}\" --top 20`\n - 生成 HTML 文件，文件名格式：`小红书七日爆款笔记_{分类}_{时间戳}.html`\n - **生成后必须立即调用 `preview_url` 展示页面**，输出文件路径并自动预览；若未正常展示则用 `open_result_view` 兜底\n\n### 阶段二：用户输入\"查看更多\"\n\n1. **七日爆款笔记表格**：\n - 继续展示TOP21到实际数据末尾（根据实际数据量）\n - 延续首次输出的数据，不重复TOP1-20\n\n2. **HTML重新生成（如用户选择）**：\n - 从第一步自动缓存的 JSON 文件读取完整数据\n - 执行命令：`python scripts/gen_xhs_html.py --data_file <临时JSON文件> --category \"{分类}\" --top 50`\n - 覆盖之前的 HTML 文件\n\n### 数据一致性保障\n\n- 两个脚本使用相同的API接口\n- 相同的排序逻辑（互动数优先，备用计算）\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_weekly_fetcher.py --keyword \"睫毛膏\" --top_n 50\n```\n\n参数详见上方「调用 Key 说明」。\n\n**自动保存 JSON 数据**：脚本获取数据后会自动将原始 JSON 保存到 `.cache/` 目录，并输出保存路径（如 `原始数据已保存到: .../xhs_weekly_化妆美容_2026-05-26.json`）。Agent 需记住此路径，供后续 HTML 生成使用。\n\n**数据完整性要求**：\n\n- 确保表格所有字段和数据完整加载\n- 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试\n- 直到所有字段（排名、笔记信息、互动数、点赞、评论、收藏、分享）都有完整数据\n- **分享字段使用正确的API字段名**：`AnaAddBean.useShareCount`（累计分享数）、`AnaAddBean.addShareCount`（新增分享数）\n- **确保分享数值正确输出，避免使用错误的字段名导致数值不对**\n\n#### 第五步：输出七日爆款笔记和七日分析\n\n按照输出规范，依次输出：\n\n1. 七日爆款笔记（含更新时间）\n2. 七日热门笔记分析（3个模块）\n\n#### 第六步：展示功能询问\n\n**重要要求：必须在七日分析输出完成后立即展示，不需要等待用户回复**\n\n展示内容：\n\n```\n技能还支持以下功能：\n1️⃣ 支持订阅小红书七日爆款笔记。订阅后将在每日19:30为您推送小红书七日爆款笔记TOP50。直接回复\"订阅或 1\"即可订阅相关内容。\n2️⃣ 可生成小红书风格的html文件包。支持导出PDF，方便阅读、保存和分享。\n```\n\n回复对应的数字即可。\n\n#### 第七步：用户选择后执行对应操作\n\n**用户回复 1 / \"订阅\"**：\n- 创建每日 19:30 推送的自动化任务\n- 推送内容：小红书七日爆款笔记推荐TOP50\n\n**用户回复 2 / \"html\" / \"生成\"**：\n- **禁止再次调用 API**，从已获取的数据文件中读取\n- 首次生成（TOP20）：`python scripts/gen_xhs_html.py --data_file <临时JSON文件> --category \"{分类}\" --top 20`\n- 查看更多后生成（完整数据）：`python scripts/gen_xhs_html.py --data_file <临时JSON文件> --category \"{分类}\" --top 50`\n- HTML 文件名格式：`小红书七日爆款笔记_{分类}_{唯一时间戳}.html`\n- **HTML 生成后必须立即调用 `preview_url` 直接展示页面**，让用户无需手动查找文件即可浏览报告\n\n**输出格式**：\n\nHTML 生成后，Agent 必须执行以下步骤：\n1. 优先调用 `preview_url` 工具直接展示 HTML 页面，让用户在对话中即可浏览完整报告\n2. 若 `preview_url` 未能正常展示（用户反馈看不到），立即改用 `open_result_view` 兜底展示\n3. 同时输出文件路径，方便用户后续查找\n\n```\n📁 HTML文件包已生成 路径：/path/to/小红书七日爆款笔记_综合_20260528160530.html\n```\n\n## 订阅服务说明\n\n### 订阅内容\n\n**小红书七日热门笔记推荐TOP50**\n\n- 每日19:30更新\n- 推送往前7天的50篇热门内容\n- 包含完整分析和HTML文件\n\n### 订阅输出格式\n\n📅 小红书七日热门笔记推荐（2026-04-15 19:30每日更新往前7天的50篇内容）\n\n**🔥 【综合全部】七日爆款笔记** （更新时间：2026-04-15 19:30:00）\n\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\n| :--: | :------------------------------- | :-------------: | :---------------: | :---------------: | :---------------: | :---------------: |\n| 🥇 | [笔记标题链接]
作者名 粉丝数+ | 8w+
↑新增1w+ | 5w+
↑新增5000+ | 2w+
↑新增2000+ | 1w+
↑新增1000+ | 800+
↑新增500+ |\n\n回复\"查看更多\"可看剩余30条！✨\n\n**📊 七日热门笔记分析（Top50）**\n\n以下内容分析基于获取的全部数据（Top50）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征 | 实际效果 | 参考笔记 |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]
[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望 | 互动率提升50% | [笔记标题链接3]
[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查 | 收藏率提升55% | [笔记标题链接5]
[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力 | 曝光率提升40% | [笔记标题链接7]
[笔记标题链接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| 最高点赞 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n\n**📁 HTML文件包**\n\n```\n\n**订阅服务（是否需要订阅小红书七日热门笔记推荐？）**\n1. 每日19:30-推送小红书七日热门笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n\n## 使用示例\n\n### 示例1：关键词查询（数据=50条）\n- **场景/输入**：\"帮我查一下睫毛膏相关的爆款笔记\"\n- **执行流程**：\n 1. 匹配分类：睫毛膏 → 化妆美容\n 2. 查询化妆美容分类，返回50条数据，保存JSON到临时文件\n 3. 七日爆款笔记表格展示TOP1-20\n 4. 展示\"回复\"查看更多\"可看剩余30条！✨\"提示\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **展示功能询问**（HTML生成 + 订阅服务）\n 7. 用户选择后执行对应操作（HTML从临时JSON文件读取，不再调用API）\n\n### 示例2：泛查询热门内容（数据=30条）\n- **场景/输入**：\"最近小红书有什么热门内容\"\n- **执行流程**：\n 1. 使用\"综合全部\"分类\n 2. 查询后返回30条数据，保存JSON到临时文件\n 3. 七日爆款笔记表格展示TOP1-20\n 4. 展示\"回复\"查看更多\"可看剩余10条！✨\"提示\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **展示功能询问**（HTML生成 + 订阅服务）\n\n### 示例3：数据不足20条（数据=15条）\n- **场景/输入**：\"查询某个冷门分类\"\n- **执行流程**：\n 1. 匹配对应分类\n 2. 查询后返回15条数据，保存JSON到临时文件\n 3. 七日爆款笔记表格展示TOP1-15（全部数据）\n 4. 不展示\"查看更多\"提示（数据未超过20条）\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **展示功能询问**（HTML生成 + 订阅服务）\n\n### 示例4：查看更多内容\n- **场景/输入**：用户回复\"查看更多\"\n- **执行流程**：\n 1. 七日爆款笔记表格展示TOP21-实际数据末尾（延续之前的数据）\n 2. 如用户选择生成HTML，从临时JSON文件读取完整数据重新生成\n\n## 资源索引\n- **脚本**：见 [scripts/xhs_weekly_fetcher.py](scripts/xhs_weekly_fetcher.py)\n - 用途：获取小红书七日爆款笔记数据\n - 参数：详见上方「调用 Key 说明」\n- **脚本**：见 [scripts/gen_xhs_html.py](scripts/gen_xhs_html.py)\n - 用途：生成可视化HTML页面\n - 参数：详见上方「调用 Key 说明」\n\n## 注意事项\n- 数据每日19:00更新昨天的榜单\n- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含七日爆款笔记（更新时间）+ 七日热门笔记分析 + 功能询问\n - 🔥 七日爆款笔记（必须包含更新时间）\n - 📊 七日热门笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n - 功能询问（HTML生成 + 订阅服务，分析完成后立即展示）\n - **禁止输出遗漏，禁止胡乱输出，必须严格按照此3项内容输出**\n- **输出格式要求（强制）**：\n - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n - **禁止输出文件**：除HTML文件包外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n - **输出顺序**：严格按照七日爆款笔记 → 七日分析 → HTML文件包 → 订阅服务的顺序执行，禁止混乱输出\n- **输出顺序（严格按此顺序执行，禁止混乱输出）**：\n 1. **🔥 七日爆款笔记**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）\n 2. **📊 七日热门笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）\n 3. **功能询问**（必须在分析之后展示，提供HTML生成和订阅推送选项）\n- **HTML文件包输出要求（强制）**：\n - 必须在用户选择生成后才执行，不得自动生成\n - **禁止再次调用 API**，必须从已获取的数据文件中读取\n - HTML 文件名格式：`小红书七日爆款笔记_{分类}_{唯一时间戳}.html`\n - **生成后必须立即调用 `preview_url` 在对话中直接展示页面**，禁止只输出文件路径\n - **若 `preview_url` 未正常展示（含中文路径等兼容问题），立即改用 `open_result_view` 兜底**\n - **PDF和图片导出内容一定是正确的**\n- **功能询问输出要求（强制，必须执行）**：\n - 必须在七日分析输出完成后立即展示\n - **禁止跳过，禁止遗漏，禁止等待用户回复**\n - 提供两个选项：订阅推送 或 生成HTML文件包\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- 七日分析标题后显示\"以下内容分析基于获取的全部数据（Top{数据条数}）进行~\"\n- 分析内容从创作者视角出发，提供可执行建议\n\nFile v1.0.4:README.en.md\n\n# Xiaohongshu Weekly Viral Notes / xiaohongshu-weeklytop\r\n\r\n---\r\n\r\n## Introduction\r\n\r\nA Xiaohongshu 7-day viral notes tool designed for creators and operators — one query delivers vertical category hot rankings and deep analysis based on the TOP50 notes from the past 7 days.\r\n\r\n**Core Value**\r\n\r\n- Solves the \"I don't know what's trending or why\" problem in topic selection — a 7-day window is more stable and reliable than a single day\r\n- Real-time hot rankings + smart analysis + exportable HTML reports, supporting review sessions and creative decisions\r\n- Keyword auto-matching across 25 vertical categories lowers the barrier to query\r\n\r\n**Who It's For**\r\n\r\n- ✍️ Xiaohongshu creators — understand what content tends to go viral in your track over the past week, and find replicable topic directions\r\n- 📢 Brand marketing managers — monitor vertical category viral content trends to optimize placements and seeding strategies\r\n- 🏢 MCN operations staff — provide track hot topic references for managed creators to shorten topic discussion cycles\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Recent hot rankings**: Query the past 7 days' hot notes by category, covering 25 vertical tracks to quickly grasp current traffic direction\r\n- **7-day trend analysis**: Deep insights from multiple dimensions — popular trends, hot topics, practical value — breaking down viral content commonalities\r\n- **Format pattern comparison**: Auto-identifies viral elements like high-quality covers, emotional resonance, practical value, and trend alignment\r\n- **Creative suggestions**: Delivers actionable topic directions, differentiation strategies, and high-performing post breakdowns\r\n- **Subscription push**: Daily 19:30 scheduled delivery of the latest trend analysis reports\r\n\r\n### Highlights\r\n\r\n- Hot ranking tables and HTML pages share the same data source and sort logic — rankings are fully consistent\r\n- First display shows TOP20; reply \"load more\" to get remaining data, HTML updates to full version\r\n- Focused on low-follower high-engagement notes, ideal for finding authentic benchmark viral samples\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=github) (`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 track 7-day hot rankings | `Show me viral notes related to mascara` | Auto-matches \"Beauty & Makeup\", outputs TOP20 hot rankings + 7-day analysis + HTML + subscription option |\r\n| Query general hot content | `What's trending on Xiaohongshu lately?` | Uses \"All\" category, full four-section standard output |\r\n| Query specific date | `Show fashion track hot rankings for 2026-04-15` | Fetches data for the specified date |\r\n| Load more | Reply \"load more\" | Continues output from TOP21 to end; HTML regenerated as full version |\r\n| Subscribe to daily push | Reply `1` after output completes | Activates daily 19:30 7-day viral notes push |\r\n\r\n### Output Example\r\n\r\nEach query produces four fixed sections: recent hot rankings TOP20 → 7-day viral analysis (trends + topics + format patterns) → 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| Creator topic inspiration | New Xiaohongshu creator | `Show 7-day hot rankings in skincare` | Quickly find replicable topic directions to lower cold-start trial-and-error costs |\r\n| Brand competitor monitoring | Brand marketing manager | `Query lipstick 7-day virals and export HTML` | Grasp category content direction to optimize placement and seeding strategies |\r\n| Creator operations review | MCN ops staff | `Query fashion 7-day rankings and subscribe to push` | Break down viral title types and continuously track hot topics for creator topic planning |\r\n| Data insights reporting | Growth / data analyst | `Fetch full food TOP50 and export HTML` | Get a shareable, archivable data report to support weekly reviews and strategy sessions |\n\nFile v1.0.4:skill-card.md\n\n## Description:
\n专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[if530770](https://clawhub.ai/user/if530770)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal creators, brand marketing teams, MCN operators, and growth analysts use this skill to query Xiaohongshu seven-day hot-note rankings, inspect trend patterns, and generate shareable reporting for content planning.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires a RedFox API key and may guide users toward persistent environment configuration.
\nMitigation: Use a scoped, revocable key; provide it through the current session or a secret manager when possible; do not let an agent edit shell startup files without explicit review.
\nRisk: Generated HTML reports can include data returned by an external API and load browser-side export libraries.
\nMitigation: Open generated reports only when the API source and content are trusted, and review or delete generated report and cache files after use.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/if530770/xhs-weekly-ranking)
\n- [Core workflow](references/core_workflow.md)
\n- [RedFoxHub](https://redfox.hk/)
\n- [RedFox API keys](https://redfox.hk/settings/api-keys?source=github)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]
\n**Output Format:** [Markdown tables and analysis, optional generated HTML report files, shell command examples, and API-key configuration guidance.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Fetches Xiaohongshu ranking data through the RedFox API, initially presents TOP20 results, can continue to TOP50, and can render a local HTML report from fetched data.]
\n\n## Skill Version(s):
\n1.0.4 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.3: 7 files, 31959 bytes\n\nFiles: _skillhub_meta.json (88b), references/core_workflow.md (31900b), scripts/gen_xhs_html.py (31516b), scripts/xhs_weekly_fetcher.py (26965b), skill-card.md (2241b), SKILL.md (6256b), _meta.json (137b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: xhs-weekly-ranking\ndescription: 获取小红书平台爆款内容榜单，支持按分类查询热门笔记；当用户需要查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感时使用\n---\n\n# 小红书七日热榜\n\n触发本技能并需要执行完整流程时，**必须先读取**与本技能同目录下的 `references/core_workflow.md`，并**完整遵循**其中的触发规则、术语规范、数据来源约束、操作步骤、自检清单与注意事项。脚本路径相对于技能目录：`scripts/xhs_weekly_fetcher.py`。\n\n---\n\n## 简介\n\n小红书七日热榜是专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送，帮你快速摸清赛道流量密码。\n\n通过简单的关键词查询，你可以：\n\n1.实时热榜查询：按分类查询热门笔记，覆盖美妆、穿搭、美食、家居等25个垂直领域，快速掌握当下流量风向\n\n2.七日热门分析：基于近7天各分类TOP50热门笔记的深度洞察，从流行趋势、热门话题深度分析、实用价值等维度拆解爆款共性\n\n3.内容特征识别：自动识别高质量封面、情绪共鸣点、实用价值、紧跟热点等爆款要素，提炼可复用的创作范式\n\n4.形式规律对比：图文笔记、视频笔记、混合形式的互动数据对比，帮你判断哪种形式转化效率更高\n\n5.创作建议输出：基于分析结果，提供可执行的选题方向、差异化策略、高维作品拆解建议\n\n6.每日订阅推送：定时推送最新趋势分析报告，持续跟踪赛道热点，不错过任何一个流量机会\n\n适用于品牌方、MCN 机构、自媒体从业者、内容运营等需要监测小红书热门趋势的场景。\n\n---\n\n## 功能特性\n\n### 🎯 核心功能\n\n- **📊 实时热榜获取：** 支持按关键词自动匹配25个垂直分类，获取往前7天热门笔记TOP50，含互动数/点赞/评论/收藏/分享及新增数据\n- **📈 七日热门笔记分析：** 自动生成热门内容分析、爆款标题分析、最高数据作品分析三大模块，从创作者视角提供可执行建议\n- **📁 HTML可视化文件：** 一键生成可独立打开的HTML页面，支持链接跳转、导出图片和PDF，方便汇报与存档\n- **🔔 订阅推送服务：** 支持每日19:30自动推送小红书七日热门笔记TOP50，无需手动重复查询\n\n### ✨ 特色亮点\n\n- **🏷️ 全分类覆盖：** 支持综合全部、化妆美容、时尚穿搭、美味佳肴等25个主流内容分类查询\n- **🔍 智能分类匹配：** 输入关键词自动匹配对应分类（如\"睫毛膏\"→化妆美容），无需手动选择\n- **⏰ 灵活日期适配：** 支持指定日期查询，未指定时自动按19:00更新规则判断查询日期\n- **📄 多格式输出：** Markdown表格 + HTML可视化文件双格式，无论自用还是做汇报都能用\n- **⚡️ 无额外门槛：** 无需小红书账号、无需API密钥，安装依赖即可使用\n\n---\n\n## 使用指南\n\n### 基础使用\n\n#### 1. 发起查询\n\n告诉工具你要查询的关键词或分类（未指定分类则自动匹配，未指定日期则按19:00规则判断）：\n\n> 用户：帮我查一下睫毛膏相关的爆款笔记\n>\n> 助手：已匹配\"化妆美容\"分类，查询到50条热门笔记，随后输出实时热榜TOP20 + 七日分析 + HTML文件包 + 订阅选项\n\n#### 2. 查看更多\n\n默认输出TOP20内容，输入「查看更多」即可获取剩余数据：\n\n> 用户：查看更多\n>\n> 助手：为你展示TOP21-50的剩余30条热门笔记，并重新生成包含完整数据的HTML文件\n\n#### 3. 订阅推送\n\n回复对应数字即可开通每日推送：\n\n> 用户：1\n>\n> 助手：已为你开通小红书七日热门笔记订阅，每日19:30将推送当日TOP50榜单到你的消息栏\n\n### 高级使用\n\n#### 1. 指定日期查询\n\n> 用户：查2026-04-20美妆类爆款笔记\n\n#### 2. 泛查询热门内容\n\n> 用户：最近小红书有什么热门内容\n\n#### 3. 取消订阅\n\n> 用户：取消订阅\n\n### 常用命令速查\n\n| 命令 | 功能 |\n| --------------------- | ---------------------------- |\n| `查[关键词]爆款` | 查询指定关键词的爆款笔记榜单 |\n| `查[日期] [分类]爆款` | 查询指定日期/分类的爆文榜单 |\n| `查看更多` | 展示剩余数据（TOP21-末尾） |\n| `订阅` | 开通每日19:30爆款推送 |\n| `取消订阅` | 关闭每日推送服务 |\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 需求 | 使用方式 |\n| ----------------------- | ------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| 🎨 内容创作者找爆款灵感 | 美妆博主 | 不知道做什么内容能爆，想快速找到对标参考 | ① 输入\"化妆美容\"查询七日热门榜单，拆解标题规律和内容特征
② 查看最高数据作品分析，了解封面设计和内容价值的关键要素
③ 订阅每日推送，持续追踪热门趋势变化 |\n| 📢 品牌运营追踪热点方向 | 快消品牌小红书运营 | 紧跟平台最新热点，做符合用户喜好的营销内容 | ① 按周查询对应分类的综合爆款，提取近期热门关键词和内容形式
② 利用HTML文件导出PDF，制作周报汇报给团队 |\n| 🔍 MCN 挖掘潜力账号 | MCN 内容星探 | 发现高互动的新账号，降低签约成本 | ① 每天查看各分类热门榜单，筛选同领域高互动的新账号
② 结合七日分析中的\"最高互动作品\"，评估账号成长性 |\n\n---\n\nFile v1.0.3:_meta.json\n\n{\n \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n \"slug\": \"xhs-weekly-ranking\",\n \"version\": \"1.0.3\",\n \"publishedAt\": 1778239842852\n}\n\nFile v1.0.3:references/core_workflow.md\n\n## 任务目标\n\n- 本 Skill 用于：获取小红书平台爆款内容榜单数据\n- 能力包含：\n - 实时热榜数据获取（按分类查询）\n - 七日热门笔记智能分析\n - 冷门爆款笔记挖掘（关键词匹配分类）\n - 订阅服务（每日定时推送）\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\n\n## 数据接口更新规则\n\n- **更新时间**：每天19:00更新昨天的榜单数据\n- **数据范围**：往前7天的热门笔记TOP50\n- **分类覆盖**：25个垂直领域分类\n\n## 输出规范（强制执行）\n\n**数据一致性要求（重要）**：\n\n- 实时热榜表格与HTML页面数据必须完全一致（相同排序、相同内容）\n- 两个脚本使用相同的API接口和排序逻辑（互动数优先，备用计算：点赞+收藏*2+评论*3+分享\\*5）\n- 禁止胡乱渲染或使用不同数据源\n\n**输出内容必须严格包含以下三部分，禁止遗漏或胡乱输出：**\n\n- **实时热榜（更新时间）**：必须直接输出，禁止折叠\n- **七日热门笔记分析**：必须直接输出，禁止折叠\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- 标题格式：**🔥 【{分类名称}】实时热榜 （更新时间：YYYY-MM-DD HH:MM:SS）**（标题整体加粗）\n- 标题示例：**🔥 【化妆美容】实时热榜 （更新时间：2025-01-15 10:30:00）**\n\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\n\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\n| :--: | :------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\n| 🥇 | [笔记标题链接]
[作者名链接] 粉丝数+ | 22w+
↑新增23w+ | 22w+
↑新增21w+ | 893
↑新增21w+ | 1w+
↑新增21w+ | 1w+
↑新增21w+ |\n| 🥈 | [笔记标题链接]
[作者名链接] 粉丝数+ | 20w+
↑新增18w+ | 18w+
↑新增16w+ | 756
↑新增18w+ | 8k+
↑新增16w+ | 900+
↑新增16w+ |\n| 🥉 | [笔记标题链接]
[作者名链接] 粉丝数+ | 18w+
↑新增15w+ | 15w+
↑新增13w+ | 621
↑新增15w+ | 7k+
↑新增13w+ | 800+
↑新增13w+ |\n\n**字段详细说明**：\n\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\n- **笔记信息**：\n - 第一行：笔记标题（可点击跳转）\n - 第二行：[作者名链接] 粉丝数+（作者名可点击跳转到作者主页，字号与标题一样大）\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- 单元格内使用 `
` 换行显示累计数据和新增数据\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\n- 新增数据格式：累计数据
↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\n- \"↑新增\"文案字号比累计数据小一号\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\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- 示例：**📊 七日热门笔记分析（Top50）**\n\n以下内容分析基于获取的全部数据（Top{数据条数}）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征 | 实际效果 | 参考笔记 |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]
[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望 | 互动率提升50% | [笔记标题链接3]
[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查 | 收藏率提升55% | [笔记标题链接5]
[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力 | 曝光率提升40% | [笔记标题链接7]
[笔记标题链接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| 最高点赞 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n\n### 第三部分：HTML文件包（必须最后输出）\n\n**强制要求（必须严格遵守）**：\n\n- HTML文件包必须在所有内容输出完成后最后输出，不得提前或插入其他内容\n- 不需要等待用户回复，七日分析输出后立即执行\n- 这是输出的最后一步，必须在实时热榜、七日分析之后\n- **禁止只输出文件路径，必须输出实际HTML文件包**\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- 不需要等待用户回复，七日分析输出后立即执行\n- 这是输出的第三步，必须在实时热榜、七日分析之后\n- **禁止只输出文件路径，必须输出实际HTML文件包**\n- **禁止折叠输出，禁止只输出文件路径，禁止遗漏**\n- 这是唯一允许输出的文件，其他内容禁止输出为文件\n\n**文件特点**：\n\n- 可独立打开的HTML文件\n- 支持直接点击链接跳转\n- 支持导出图片和PDF功能（导出结果与页面显示完全一致，PDF和图片导出内容一定是正确的）\n- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为\"↑新增数值\"格式，整体字号增大1px\n- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据，分享字段必须展示且不能出错）\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- 相同的排序逻辑（互动数优先，备用计算）\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_weekly_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文件包（必须最后执行）\n\n**重要要求：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**输出格式**：\n\n```\n**📁 HTML文件包已生成** 路径：/path/to/xhs_weekly.html\n```\n\n#### 第七步：展示订阅服务（必须在HTML文件包之后强制执行）\n\n**重要要求（强制，禁止跳过）**：必须在HTML文件包输出完成后立即展示订阅服务，不能等待用户回复，不能跳过，不能遗漏\n\n**订阅服务（是否需要订阅小红书七日热门笔记推荐？）**\n\n1. 每日19:30-推送小红书七日热门笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n\n**订阅逻辑**：小红书七日热门笔记推荐TOP50，按每日19:30更新\n\n## 订阅服务说明\n\n### 订阅内容\n\n**小红书七日热门笔记推荐TOP50**\n\n- 每日19:30更新\n- 推送往前7天的50篇热门内容\n- 包含完整分析和HTML文件\n\n### 订阅输出格式\n\n📅 小红书七日热门笔记推荐（2026-04-15 19:30每日更新往前7天的50篇内容）\n\n**🔥 【综合全部】实时热榜** （更新时间：2026-04-15 19:30:00）\n\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\n| :--: | :------------------------------- | :-------------: | :---------------: | :---------------: | :---------------: | :---------------: |\n| 🥇 | [笔记标题链接]
作者名 粉丝数+ | 8w+
↑新增1w+ | 5w+
↑新增5000+ | 2w+
↑新增2000+ | 1w+
↑新增1000+ | 800+
↑新增500+ |\n\n回复\"查看更多\"可看剩余30条！✨\n\n**📊 七日热门笔记分析（Top50）**\n\n以下内容分析基于获取的全部数据（Top50）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征 | 实际效果 | 参考笔记 |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]
[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望 | 互动率提升50% | [笔记标题链接3]
[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查 | 收藏率提升55% | [笔记标题链接5]
[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力 | 曝光率提升40% | [笔记标题链接7]
[笔记标题链接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| 最高点赞 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n\n**📁 HTML文件包**\n\n```\n\n**订阅服务（是否需要订阅小红书七日热门笔记推荐？）**\n1. 每日19:30-推送小红书七日热门笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n\n## 使用示例\n\n### 示例1：关键词查询冷门爆款（数据=50条）\n- **场景/输入**：\"帮我查一下睫毛膏相关的爆款笔记\"\n- **执行流程**：\n 1. 匹配分类：睫毛膏 → 化妆美容\n 2. 查询化妆美容分类，返回50条数据\n 3. 实时热榜表格展示TOP1-20（与HTML页面保持一致）\n 4. 展示\"回复\"查看更多\"可看剩余30条！✨\"提示\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **最后生成HTML文件包（TOP1-20）**（与热榜表格数据完全一致）\n 7. **展示订阅服务**（提供每日19:30推送选项）\n\n### 示例2：泛查询热门内容（数据=30条）\n- **场景/输入**：\"最近小红书有什么热门内容\"\n- **执行流程**：\n 1. 使用\"综合全部\"分类\n 2. 查询后返回30条数据\n 3. 实时热榜表格展示TOP1-20（与HTML页面保持一致）\n 4. 展示\"回复\"查看更多\"可看剩余10条！✨\"提示\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **最后生成HTML文件包（TOP1-20）**（与热榜表格数据完全一致）\n 7. **展示订阅服务**（提供每日19:30推送选项）\n\n### 示例3：数据不足20条（数据=15条）\n- **场景/输入**：\"查询某个冷门分类\"\n- **执行流程**：\n 1. 匹配对应分类\n 2. 查询后返回15条数据\n 3. 实时热榜表格展示TOP1-15（全部数据，与HTML页面保持一致）\n 4. 不展示\"查看更多\"提示（数据未超过20条）\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **最后生成HTML文件包（TOP1-15）**（与热榜表格数据完全一致）\n 7. **展示订阅服务**（提供每日19:30推送选项）\n\n### 示例4：查看更多内容\n- **场景/输入**：用户回复\"查看更多\"\n- **执行流程**：\n 1. 实时热榜表格展示TOP21-实际数据末尾（延续之前的数据）\n 2. **最后重新生成HTML文件包（TOP1-实际数据末尾）**（完整数据，覆盖之前的文件）\n\n## 资源索引\n- **脚本**：见 [scripts/xhs_weekly_fetcher.py](scripts/xhs_weekly_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- 数据每日19:00更新昨天的榜单\n- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含实时热榜（更新时间）+ 七日热门笔记分析 + HTML文件包 + 订阅服务\n - 🔥 实时热榜（必须包含更新时间）\n - 📊 七日热门笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n - 📁 HTML文件包（必须输出实际文件，禁止只输出文件路径）\n - 订阅服务（提供每日19:30推送选项）\n - **禁止输出遗漏，禁止胡乱输出，必须严格按照此4项内容输出**\n- **输出格式要求（强制）**：\n - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n - **禁止输出文件**：除HTML文件包外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n - **输出顺序**：严格按照实时热榜 → 七日分析 → HTML文件包 → 订阅服务的顺序执行，禁止混乱输出\n- **输出顺序（严格按此顺序执行，禁止混乱输出）**：\n 1. **🔥 实时热榜**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）\n 2. **📊 七日热门笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）\n 3. **📁 HTML文件包**（必须最后执行，七日分析后立即执行，不等待任何用户回复，必须输出实际文件）\n 4. **订阅服务**（必须在HTML文件包之后展示，提供每日19:30推送小红书七日热门笔记TOP50的订阅选项）\n- **HTML文件包输出要求（强制）**：\n - 必须在所有内容输出完成后最后输出，不得提前或插入其他内容之前\n - **禁止只输出文件路径，必须输出实际HTML文件包**\n - **禁止折叠输出**\n - **PDF和图片导出内容一定是正确的**\n - 不需要等待任何流程\n- **订阅服务输出要求（强制，必须执行）**：\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- 七日分析标题后显示\"以下内容分析基于获取的全部数据（Top{数据条数}）进行~\"\n- 分析内容从创作者视角出发，提供可执行建议\n```\n\nFile v1.0.3:skill-card.md\n\n## Description:
\n获取小红书平台爆款内容榜单，支持按分类查询热门笔记；当用户需要查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感时使用
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[if530770](https://clawhub.ai/user/if530770)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal content creators, brand operators, MCN teams, and content analysts use this skill to monitor Xiaohongshu weekly trending posts, compare category performance, and derive content ideas from popular notes.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Data fetching contacts onetotenvip.com with HTTPS verification disabled.
\nMitigation: Review before installing, use only if that endpoint is acceptable, and avoid relying on results for sensitive decisions until TLS verification is fixed.
\nRisk: Generated local HTML reports load CDN scripts when opened.
\nMitigation: Open reports only in a trusted browser environment and review generated HTML and CDN usage before sharing.
\nRisk: The skill offers daily push subscriptions.
\nMitigation: Confirm user consent and subscription opt-out behavior before enabling recurring pushes.
\n\n\n## Reference(s):
\n- [Core workflow](references/core_workflow.md)
\n- [ClawHub skill page](https://clawhub.ai/if530770/xhs-weekly-ranking)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, files, guidance]
\n**Output Format:** [Markdown tables and prose with a generated HTML report file]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Reports cover Xiaohongshu weekly ranking data, default to Top 20 with optional expansion to Top 50, and may include a daily subscription prompt.]
\n\n## Skill Version(s):
\n1.0.3 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nFile v1.0.3:_skillhub_meta.json\n\n{\n \"name\": \"xhs-weekly-ranking\",\n \"installedAt\": 1777463601172,\n \"source\": \"import\"\n}\n\nArchive v1.0.2: 6 files, 30310 bytes\n\nFiles: _skillhub_meta.json (88b), references/core_workflow.md (31900b), scripts/gen_xhs_html.py (31516b), scripts/xhs_weekly_fetcher.py (26965b), SKILL.md (5676b), _meta.json (137b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: xhs-weekly-ranking\ndescription: 获取小红书平台爆款内容榜单，支持按分类查询热门笔记；当用户需要查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感时使用\n---\n\n# 小红书爆款内容榜单获取\n\n触发本技能并需要执行完整流程时，**必须先读取**与本技能同目录下的 `references/core_workflow.md`，并**完整遵循**其中的触发规则、术语规范、数据来源约束、操作步骤、自检清单与注意事项。脚本路径相对于技能目录：`scripts/xhs_weekly_fetcher.py`。\n\n---\n\n## 简介\n\n小红书七日爆款内容榜单助手是一款专为内容创作者和营销运营人员设计的智能工具，帮助用户实时追踪小红书平台各领域的热门笔记数据。\n\n通过简单的关键词查询，你可以：\n\n- 📊 获取往前7天的热门笔记TOP50榜单，解决「找爆文效率低」的痛点\n- 📈 智能拆解爆款标题规律、内容特征、数据表现，解决「拆规律凭感觉」的痛点\n- 🔔 支持每日19:30定时推送订阅，大幅降低信息差，放大内容创作收益\n\n适用于品牌方、MCN 机构、自媒体从业者、内容运营等需要监测小红书热门趋势的场景。\n\n---\n\n## 功能特性\n\n### 🎯 核心功能\n\n- **📊 实时热榜获取：** 支持按关键词自动匹配25个垂直分类，获取往前7天热门笔记TOP50，含互动数/点赞/评论/收藏/分享及新增数据\n- **📈 七日热门笔记分析：** 自动生成热门内容分析、爆款标题分析、最高数据作品分析三大模块，从创作者视角提供可执行建议\n- **📁 HTML可视化文件：** 一键生成可独立打开的HTML页面，支持链接跳转、导出图片和PDF，方便汇报与存档\n- **🔔 订阅推送服务：** 支持每日19:30自动推送小红书七日热门笔记TOP50，无需手动重复查询\n\n### ✨ 特色亮点\n\n- **🏷️ 全分类覆盖：** 支持综合全部、化妆美容、时尚穿搭、美味佳肴等25个主流内容分类查询\n- **🔍 智能分类匹配：** 输入关键词自动匹配对应分类（如\"睫毛膏\"→化妆美容），无需手动选择\n- **⏰ 灵活日期适配：** 支持指定日期查询，未指定时自动按19:00更新规则判断查询日期\n- **📄 多格式输出：** Markdown表格 + HTML可视化文件双格式，无论自用还是做汇报都能用\n- **⚡️ 无额外门槛：** 无需小红书账号、无需API密钥，安装依赖即可使用\n\n---\n\n## 使用指南\n\n### 基础使用\n\n#### 1. 发起查询\n\n告诉工具你要查询的关键词或分类（未指定分类则自动匹配，未指定日期则按19:00规则判断）：\n\n> 用户：帮我查一下睫毛膏相关的爆款笔记\n>\n> 助手：已匹配\"化妆美容\"分类，查询到50条热门笔记，随后输出实时热榜TOP20 + 七日分析 + HTML文件包 + 订阅选项\n\n#### 2. 查看更多\n\n默认输出TOP20内容，输入「查看更多」即可获取剩余数据：\n\n> 用户：查看更多\n>\n> 助手：为你展示TOP21-50的剩余30条热门笔记，并重新生成包含完整数据的HTML文件\n\n#### 3. 订阅推送\n\n回复对应数字即可开通每日推送：\n\n> 用户：1\n>\n> 助手：已为你开通小红书七日热门笔记订阅，每日19:30将推送当日TOP50榜单到你的消息栏\n\n### 高级使用\n\n#### 1. 指定日期查询\n\n> 用户：查2026-04-20美妆类爆款笔记\n\n#### 2. 泛查询热门内容\n\n> 用户：最近小红书有什么热门内容\n\n#### 3. 取消订阅\n\n> 用户：取消订阅\n\n### 常用命令速查\n\n| 命令 | 功能 |\n| --------------------- | ---------------------------- |\n| `查[关键词]爆款` | 查询指定关键词的爆款笔记榜单 |\n| `查[日期] [分类]爆款` | 查询指定日期/分类的爆文榜单 |\n| `查看更多` | 展示剩余数据（TOP21-末尾） |\n| `订阅` | 开通每日19:30爆款推送 |\n| `取消订阅` | 关闭每日推送服务 |\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 需求 | 使用方式 |\n| ----------------------- | ------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| 🎨 内容创作者找爆款灵感 | 美妆博主 | 不知道做什么内容能爆，想快速找到对标参考 | ① 输入\"化妆美容\"查询七日热门榜单，拆解标题规律和内容特征
② 查看最高数据作品分析，了解封面设计和内容价值的关键要素
③ 订阅每日推送，持续追踪热门趋势变化 |\n| 📢 品牌运营追踪热点方向 | 快消品牌小红书运营 | 紧跟平台最新热点，做符合用户喜好的营销内容 | ① 按周查询对应分类的综合爆款，提取近期热门关键词和内容形式
② 利用HTML文件导出PDF，制作周报汇报给团队 |\n| 🔍 MCN 挖掘潜力账号 | MCN 内容星探 | 发现高互动的新账号，降低签约成本 | ① 每天查看各分类热门榜单，筛选同领域高互动的新账号
② 结合七日分析中的\"最高互动作品\"，评估账号成长性 |\n\n---\n\nFile v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n \"slug\": \"xhs-weekly-ranking\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1777466491068\n}\n\nFile v1.0.2:references/core_workflow.md\n\n## 任务目标\n\n- 本 Skill 用于：获取小红书平台爆款内容榜单数据\n- 能力包含：\n - 实时热榜数据获取（按分类查询）\n - 七日热门笔记智能分析\n - 冷门爆款笔记挖掘（关键词匹配分类）\n - 订阅服务（每日定时推送）\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\n\n## 数据接口更新规则\n\n- **更新时间**：每天19:00更新昨天的榜单数据\n- **数据范围**：往前7天的热门笔记TOP50\n- **分类覆盖**：25个垂直领域分类\n\n## 输出规范（强制执行）\n\n**数据一致性要求（重要）**：\n\n- 实时热榜表格与HTML页面数据必须完全一致（相同排序、相同内容）\n- 两个脚本使用相同的API接口和排序逻辑（互动数优先，备用计算：点赞+收藏*2+评论*3+分享\\*5）\n- 禁止胡乱渲染或使用不同数据源\n\n**输出内容必须严格包含以下三部分，禁止遗漏或胡乱输出：**\n\n- **实时热榜（更新时间）**：必须直接输出，禁止折叠\n- **七日热门笔记分析**：必须直接输出，禁止折叠\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- 标题格式：**🔥 【{分类名称}】实时热榜 （更新时间：YYYY-MM-DD HH:MM:SS）**（标题整体加粗）\n- 标题示例：**🔥 【化妆美容】实时热榜 （更新时间：2025-01-15 10:30:00）**\n\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\n\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\n| :--: | :------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\n| 🥇 | [笔记标题链接]
[作者名链接] 粉丝数+ | 22w+
↑新增23w+ | 22w+
↑新增21w+ | 893
↑新增21w+ | 1w+
↑新增21w+ | 1w+
↑新增21w+ |\n| 🥈 | [笔记标题链接]
[作者名链接] 粉丝数+ | 20w+
↑新增18w+ | 18w+
↑新增16w+ | 756
↑新增18w+ | 8k+
↑新增16w+ | 900+
↑新增16w+ |\n| 🥉 | [笔记标题链接]
[作者名链接] 粉丝数+ | 18w+
↑新增15w+ | 15w+
↑新增13w+ | 621
↑新增15w+ | 7k+
↑新增13w+ | 800+
↑新增13w+ |\n\n**字段详细说明**：\n\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\n- **笔记信息**：\n - 第一行：笔记标题（可点击跳转）\n - 第二行：[作者名链接] 粉丝数+（作者名可点击跳转到作者主页，字号与标题一样大）\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- 单元格内使用 `
` 换行显示累计数据和新增数据\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\n- 新增数据格式：累计数据
↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\n- \"↑新增\"文案字号比累计数据小一号\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\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- 示例：**📊 七日热门笔记分析（Top50）**\n\n以下内容分析基于获取的全部数据（Top{数据条数}）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征 | 实际效果 | 参考笔记 |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]
[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望 | 互动率提升50% | [笔记标题链接3]
[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查 | 收藏率提升55% | [笔记标题链接5]
[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力 | 曝光率提升40% | [笔记标题链接7]
[笔记标题链接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| 最高点赞 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n\n### 第三部分：HTML文件包（必须最后输出）\n\n**强制要求（必须严格遵守）**：\n\n- HTML文件包必须在所有内容输出完成后最后输出，不得提前或插入其他内容\n- 不需要等待用户回复，七日分析输出后立即执行\n- 这是输出的最后一步，必须在实时热榜、七日分析之后\n- **禁止只输出文件路径，必须输出实际HTML文件包**\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- 不需要等待用户回复，七日分析输出后立即执行\n- 这是输出的第三步，必须在实时热榜、七日分析之后\n- **禁止只输出文件路径，必须输出实际HTML文件包**\n- **禁止折叠输出，禁止只输出文件路径，禁止遗漏**\n- 这是唯一允许输出的文件，其他内容禁止输出为文件\n\n**文件特点**：\n\n- 可独立打开的HTML文件\n- 支持直接点击链接跳转\n- 支持导出图片和PDF功能（导出结果与页面显示完全一致，PDF和图片导出内容一定是正确的）\n- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为\"↑新增数值\"格式，整体字号增大1px\n- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据，分享字段必须展示且不能出错）\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- 相同的排序逻辑（互动数优先，备用计算）\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_weekly_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文件包（必须最后执行）\n\n**重要要求：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**输出格式**：\n\n```\n**📁 HTML文件包已生成** 路径：/path/to/xhs_weekly.html\n```\n\n#### 第七步：展示订阅服务（必须在HTML文件包之后强制执行）\n\n**重要要求（强制，禁止跳过）**：必须在HTML文件包输出完成后立即展示订阅服务，不能等待用户回复，不能跳过，不能遗漏\n\n**订阅服务（是否需要订阅小红书七日热门笔记推荐？）**\n\n1. 每日19:30-推送小红书七日热门笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n\n**订阅逻辑**：小红书七日热门笔记推荐TOP50，按每日19:30更新\n\n## 订阅服务说明\n\n### 订阅内容\n\n**小红书七日热门笔记推荐TOP50**\n\n- 每日19:30更新\n- 推送往前7天的50篇热门内容\n- 包含完整分析和HTML文件\n\n### 订阅输出格式\n\n📅 小红书七日热门笔记推荐（2026-04-15 19:30每日更新往前7天的50篇内容）\n\n**🔥 【综合全部】实时热榜** （更新时间：2026-04-15 19:30:00）\n\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\n| :--: | :------------------------------- | :-------------: | :---------------: | :---------------: | :---------------: | :---------------: |\n| 🥇 | [笔记标题链接]
作者名 粉丝数+ | 8w+
↑新增1w+ | 5w+
↑新增5000+ | 2w+
↑新增2000+ | 1w+
↑新增1000+ | 800+
↑新增500+ |\n\n回复\"查看更多\"可看剩余30条！✨\n\n**📊 七日热门笔记分析（Top50）**\n\n以下内容分析基于获取的全部数据（Top50）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征 | 实际效果 | 参考笔记 |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]
[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望 | 互动率提升50% | [笔记标题链接3]
[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查 | 收藏率提升55% | [笔记标题链接5]
[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力 | 曝光率提升40% | [笔记标题链接7]
[笔记标题链接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| 最高点赞 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n\n**📁 HTML文件包**\n\n```\n\n**订阅服务（是否需要订阅小红书七日热门笔记推荐？）**\n1. 每日19:30-推送小红书七日热门笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n\n## 使用示例\n\n### 示例1：关键词查询冷门爆款（数据=50条）\n- **场景/输入**：\"帮我查一下睫毛膏相关的爆款笔记\"\n- **执行流程**：\n 1. 匹配分类：睫毛膏 → 化妆美容\n 2. 查询化妆美容分类，返回50条数据\n 3. 实时热榜表格展示TOP1-20（与HTML页面保持一致）\n 4. 展示\"回复\"查看更多\"可看剩余30条！✨\"提示\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **最后生成HTML文件包（TOP1-20）**（与热榜表格数据完全一致）\n 7. **展示订阅服务**（提供每日19:30推送选项）\n\n### 示例2：泛查询热门内容（数据=30条）\n- **场景/输入**：\"最近小红书有什么热门内容\"\n- **执行流程**：\n 1. 使用\"综合全部\"分类\n 2. 查询后返回30条数据\n 3. 实时热榜表格展示TOP1-20（与HTML页面保持一致）\n 4. 展示\"回复\"查看更多\"可看剩余10条！✨\"提示\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **最后生成HTML文件包（TOP1-20）**（与热榜表格数据完全一致）\n 7. **展示订阅服务**（提供每日19:30推送选项）\n\n### 示例3：数据不足20条（数据=15条）\n- **场景/输入**：\"查询某个冷门分类\"\n- **执行流程**：\n 1. 匹配对应分类\n 2. 查询后返回15条数据\n 3. 实时热榜表格展示TOP1-15（全部数据，与HTML页面保持一致）\n 4. 不展示\"查看更多\"提示（数据未超过20条）\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **最后生成HTML文件包（TOP1-15）**（与热榜表格数据完全一致）\n 7. **展示订阅服务**（提供每日19:30推送选项）\n\n### 示例4：查看更多内容\n- **场景/输入**：用户回复\"查看更多\"\n- **执行流程**：\n 1. 实时热榜表格展示TOP21-实际数据末尾（延续之前的数据）\n 2. **最后重新生成HTML文件包（TOP1-实际数据末尾）**（完整数据，覆盖之前的文件）\n\n## 资源索引\n- **脚本**：见 [scripts/xhs_weekly_fetcher.py](scripts/xhs_weekly_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- 数据每日19:00更新昨天的榜单\n- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含实时热榜（更新时间）+ 七日热门笔记分析 + HTML文件包 + 订阅服务\n - 🔥 实时热榜（必须包含更新时间）\n - 📊 七日热门笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n - 📁 HTML文件包（必须输出实际文件，禁止只输出文件路径）\n - 订阅服务（提供每日19:30推送选项）\n - **禁止输出遗漏，禁止胡乱输出，必须严格按照此4项内容输出**\n- **输出格式要求（强制）**：\n - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n - **禁止输出文件**：除HTML文件包外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n - **输出顺序**：严格按照实时热榜 → 七日分析 → HTML文件包 → 订阅服务的顺序执行，禁止混乱输出\n- **输出顺序（严格按此顺序执行，禁止混乱输出）**：\n 1. **🔥 实时热榜**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）\n 2. **📊 七日热门笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）\n 3. **📁 HTML文件包**（必须最后执行，七日分析后立即执行，不等待任何用户回复，必须输出实际文件）\n 4. **订阅服务**（必须在HTML文件包之后展示，提供每日19:30推送小红书七日热门笔记TOP50的订阅选项）\n- **HTML文件包输出要求（强制）**：\n - 必须在所有内容输出完成后最后输出，不得提前或插入其他内容之前\n - **禁止只输出文件路径，必须输出实际HTML文件包**\n - **禁止折叠输出**\n - **PDF和图片导出内容一定是正确的**\n - 不需要等待任何流程\n- **订阅服务输出要求（强制，必须执行）**：\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- 七日分析标题后显示\"以下内容分析基于获取的全部数据（Top{数据条数}）进行~\"\n- 分析内容从创作者视角出发，提供可执行建议\n```\n\nFile v1.0.2:_skillhub_meta.json\n\n{\n \"name\": \"xhs-weekly-ranking\",\n \"installedAt\": 1777463601172,\n \"source\": \"import\"\n}\n\nArchive v1.0.1: 6 files, 31381 bytes\n\nFiles: _skillhub_meta.json (88b), references/core_workflow.md (31900b), scripts/gen_xhs_html.py (31516b), scripts/xhs_weekly_fetcher.py (26965b), SKILL.md (7680b), _meta.json (137b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: xhs-weekly-ranking\ndescription: 获取小红书平台爆款内容榜单，支持按分类查询热门笔记；当用户需要查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感时使用\n---\n\n# 小红书爆款内容榜单获取\n\n触发本技能并需要执行完整流程时，**必须先读取**与本技能同目录下的 `references/core_workflow.md`，并**完整遵循**其中的触发规则、术语规范、数据来源约束、操作步骤、自检清单与注意事项。脚本路径相对于技能目录：`scripts/xhs_weekly_fetcher.py`。\n\n---\n\n## 简介\n\n小红书七日爆款内容榜单助手是一款专为内容创作者和营销运营人员设计的智能工具，帮助用户实时追踪小红书平台各领域的热门笔记数据。\n\n通过简单的关键词查询，你可以：\n\n- 📊 获取往前7天的热门笔记TOP50榜单，解决「找爆文效率低」的痛点\n- 📈 智能拆解爆款标题规律、内容特征、数据表现，解决「拆规律凭感觉」的痛点\n- 🔔 支持每日19:30定时推送订阅，大幅降低信息差，放大内容创作收益\n\n适用于品牌方、MCN 机构、自媒体从业者、内容运营等需要监测小红书热门趋势的场景。\n\n---\n\n## 功能特性\n\n### 🎯 核心功能\n\n- **📊 实时热榜获取：** 支持按关键词自动匹配25个垂直分类，获取往前7天热门笔记TOP50，含互动数/点赞/评论/收藏/分享及新增数据\n- **📈 七日热门笔记分析：** 自动生成热门内容分析、爆款标题分析、最高数据作品分析三大模块，从创作者视角提供可执行建议\n- **📁 HTML可视化文件：** 一键生成可独立打开的HTML页面，支持链接跳转、导出图片和PDF，方便汇报与存档\n- **🔔 订阅推送服务：** 支持每日19:30自动推送小红书七日热门笔记TOP50，无需手动重复查询\n\n### ✨ 特色亮点\n\n- **🏷️ 全分类覆盖：** 支持综合全部、化妆美容、时尚穿搭、美味佳肴等25个主流内容分类查询\n- **🔍 智能分类匹配：** 输入关键词自动匹配对应分类（如\"睫毛膏\"→化妆美容），无需手动选择\n- **⏰ 灵活日期适配：** 支持指定日期查询，未指定时自动按19:00更新规则判断查询日期\n- **📄 多格式输出：** Markdown表格 + HTML可视化文件双格式，无论自用还是做汇报都能用\n- **⚡️ 无额外门槛：** 无需小红书账号、无需API密钥，安装依赖即可使用\n\n---\n\n## 使用指南\n\n### 基础使用\n\n#### 1. 发起查询\n\n告诉工具你要查询的关键词或分类（未指定分类则自动匹配，未指定日期则按19:00规则判断）：\n\n> 用户：帮我查一下睫毛膏相关的爆款笔记\n>\n> 助手：已匹配\"化妆美容\"分类，查询到50条热门笔记，随后输出实时热榜TOP20 + 七日分析 + HTML文件包 + 订阅选项\n\n#### 2. 查看更多\n\n默认输出TOP20内容，输入「查看更多」即可获取剩余数据：\n\n> 用户：查看更多\n>\n> 助手：为你展示TOP21-50的剩余30条热门笔记，并重新生成包含完整数据的HTML文件\n\n#### 3. 订阅推送\n\n回复对应数字即可开通每日推送：\n\n> 用户：1\n>\n> 助手：已为你开通小红书七日热门笔记订阅，每日19:30将推送当日TOP50榜单到你的消息栏\n\n### 高级使用\n\n#### 1. 指定日期查询\n\n> 用户：查2026-04-20美妆类爆款笔记\n\n#### 2. 泛查询热门内容\n\n> 用户：最近小红书有什么热门内容\n\n#### 3. 取消订阅\n\n> 用户：取消订阅\n\n### 常用命令速查\n\n| 命令 | 功能 |\n| --------------------- | ---------------------------- |\n| `查[关键词]爆款` | 查询指定关键词的爆款笔记榜单 |\n| `查[日期] [分类]爆款` | 查询指定日期/分类的爆文榜单 |\n| `查看更多` | 展示剩余数据（TOP21-末尾） |\n| `订阅` | 开通每日19:30爆款推送 |\n| `取消订阅` | 关闭每日推送服务 |\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 需求 | 使用方式 |\n| ----------------------- | ------------------ | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| 🎨 内容创作者找爆款灵感 | 美妆博主 | 不知道做什么内容能爆，想快速找到对标参考 | ① 输入\"化妆美容\"查询七日热门榜单，拆解标题规律和内容特征
② 查看最高数据作品分析，了解封面设计和内容价值的关键要素
③ 订阅每日推送，持续追踪热门趋势变化 |\n| 📢 品牌运营追踪热点方向 | 快消品牌小红书运营 | 紧跟平台最新热点，做符合用户喜好的营销内容 | ① 按周查询对应分类的综合爆款，提取近期热门关键词和内容形式
② 利用HTML文件导出PDF，制作周报汇报给团队 |\n| 🔍 MCN 挖掘潜力账号 | MCN 内容星探 | 发现高互动的新账号，降低签约成本 | ① 每天查看各分类热门榜单，筛选同领域高互动的新账号
② 结合七日分析中的\"最高互动作品\"，评估账号成长性 |\n\n---\n\n---\n\n## 常见问答\n\n### 安装相关问题\n\n**Q1: 安装依赖时报错怎么办？**\n\nA: 请检查以下几点：\n\n1. 确认 Python 版本 >= 3.8（运行 `python --version` 查看）\n2. 尝试使用国内镜像源安装：`pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple`\n3. 如遇到权限问题，尝试加上 `--user` 参数\n\n**Q2: 需要配置小红书账号或API Key吗？**\n\nA: 不需要。本技能使用小红书公开数据接口，无需账号登录或API密钥，安装依赖即可使用。\n\n---\n\n### 使用相关问题\n\n**Q3: 数据多久更新一次？**\n\nA: 每日19:00更新昨天的榜单数据。如果当前时间未到19:00，则查询的是前天数据；19:00之后查询的为昨日数据。\n\n**Q4: 支持哪些分类查询？**\n\nA: 支持共25个垂直分类：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼。\n\n**Q5: 为什么有些分类数据不足50条？**\n\nA: 部分垂直分类内容热度较低，可能返回少于50条数据，这是正常现象。数据不足20条时不会展示\"查看更多\"提示。\n\n---\n\n### 故障排除\n\n**Q6: HTML文件生成失败怎么办？**\n\nA: 请按以下步骤排查：\n\n1. 检查是否有数据返回（先确认热榜表格正常输出）\n2. 确认 `scripts/gen_xhs_html.py` 文件存在且未被修改\n3. 尝试手动执行：`python scripts/gen_xhs_html.py --keyword \"测试\" --top 20`\n\n**Q7: 分享字段数据为空或错误怎么办？**\n\nA: 分享字段使用 `AnaAddBean.useShareCount`（累计分享数）和 `AnaAddBean.addShareCount`（新增分享数），如果数据加载失败或字段缺失，系统会自动重新调用脚本尝试，直到字段数据完整。\n\n---\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n \"slug\": \"xhs-weekly-ranking\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1777465136735\n}\n\nFile v1.0.1:references/core_workflow.md\n\n## 任务目标\n\n- 本 Skill 用于：获取小红书平台爆款内容榜单数据\n- 能力包含：\n - 实时热榜数据获取（按分类查询）\n - 七日热门笔记智能分析\n - 冷门爆款笔记挖掘（关键词匹配分类）\n - 订阅服务（每日定时推送）\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\n\n## 数据接口更新规则\n\n- **更新时间**：每天19:00更新昨天的榜单数据\n- **数据范围**：往前7天的热门笔记TOP50\n- **分类覆盖**：25个垂直领域分类\n\n## 输出规范（强制执行）\n\n**数据一致性要求（重要）**：\n\n- 实时热榜表格与HTML页面数据必须完全一致（相同排序、相同内容）\n- 两个脚本使用相同的API接口和排序逻辑（互动数优先，备用计算：点赞+收藏*2+评论*3+分享\\*5）\n- 禁止胡乱渲染或使用不同数据源\n\n**输出内容必须严格包含以下三部分，禁止遗漏或胡乱输出：**\n\n- **实时热榜（更新时间）**：必须直接输出，禁止折叠\n- **七日热门笔记分析**：必须直接输出，禁止折叠\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- 标题格式：**🔥 【{分类名称}】实时热榜 （更新时间：YYYY-MM-DD HH:MM:SS）**（标题整体加粗）\n- 标题示例：**🔥 【化妆美容】实时热榜 （更新时间：2025-01-15 10:30:00）**\n\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\n\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\n| :--: | :------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\n| 🥇 | [笔记标题链接]
[作者名链接] 粉丝数+ | 22w+
↑新增23w+ | 22w+
↑新增21w+ | 893
↑新增21w+ | 1w+
↑新增21w+ | 1w+
↑新增21w+ |\n| 🥈 | [笔记标题链接]
[作者名链接] 粉丝数+ | 20w+
↑新增18w+ | 18w+
↑新增16w+ | 756
↑新增18w+ | 8k+
↑新增16w+ | 900+
↑新增16w+ |\n| 🥉 | [笔记标题链接]
[作者名链接] 粉丝数+ | 18w+
↑新增15w+ | 15w+
↑新增13w+ | 621
↑新增15w+ | 7k+
↑新增13w+ | 800+
↑新增13w+ |\n\n**字段详细说明**：\n\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\n- **笔记信息**：\n - 第一行：笔记标题（可点击跳转）\n - 第二行：[作者名链接] 粉丝数+（作者名可点击跳转到作者主页，字号与标题一样大）\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- 单元格内使用 `
` 换行显示累计数据和新增数据\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\n- 新增数据格式：累计数据
↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\n- \"↑新增\"文案字号比累计数据小一号\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\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- 示例：**📊 七日热门笔记分析（Top50）**\n\n以下内容分析基于获取的全部数据（Top{数据条数}）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征 | 实际效果 | 参考笔记 |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]
[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望 | 互动率提升50% | [笔记标题链接3]
[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查 | 收藏率提升55% | [笔记标题链接5]
[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力 | 曝光率提升40% | [笔记标题链接7]
[笔记标题链接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| 最高点赞 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n\n### 第三部分：HTML文件包（必须最后输出）\n\n**强制要求（必须严格遵守）**：\n\n- HTML文件包必须在所有内容输出完成后最后输出，不得提前或插入其他内容\n- 不需要等待用户回复，七日分析输出后立即执行\n- 这是输出的最后一步，必须在实时热榜、七日分析之后\n- **禁止只输出文件路径，必须输出实际HTML文件包**\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- 不需要等待用户回复，七日分析输出后立即执行\n- 这是输出的第三步，必须在实时热榜、七日分析之后\n- **禁止只输出文件路径，必须输出实际HTML文件包**\n- **禁止折叠输出，禁止只输出文件路径，禁止遗漏**\n- 这是唯一允许输出的文件，其他内容禁止输出为文件\n\n**文件特点**：\n\n- 可独立打开的HTML文件\n- 支持直接点击链接跳转\n- 支持导出图片和PDF功能（导出结果与页面显示完全一致，PDF和图片导出内容一定是正确的）\n- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为\"↑新增数值\"格式，整体字号增大1px\n- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据，分享字段必须展示且不能出错）\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- 相同的排序逻辑（互动数优先，备用计算）\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_weekly_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文件包（必须最后执行）\n\n**重要要求：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**输出格式**：\n\n```\n**📁 HTML文件包已生成** 路径：/path/to/xhs_weekly.html\n```\n\n#### 第七步：展示订阅服务（必须在HTML文件包之后强制执行）\n\n**重要要求（强制，禁止跳过）**：必须在HTML文件包输出完成后立即展示订阅服务，不能等待用户回复，不能跳过，不能遗漏\n\n**订阅服务（是否需要订阅小红书七日热门笔记推荐？）**\n\n1. 每日19:30-推送小红书七日热门笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n\n**订阅逻辑**：小红书七日热门笔记推荐TOP50，按每日19:30更新\n\n## 订阅服务说明\n\n### 订阅内容\n\n**小红书七日热门笔记推荐TOP50**\n\n- 每日19:30更新\n- 推送往前7天的50篇热门内容\n- 包含完整分析和HTML文件\n\n### 订阅输出格式\n\n📅 小红书七日热门笔记推荐（2026-04-15 19:30每日更新往前7天的50篇内容）\n\n**🔥 【综合全部】实时热榜** （更新时间：2026-04-15 19:30:00）\n\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\n| :--: | :------------------------------- | :-------------: | :---------------: | :---------------: | :---------------: | :---------------: |\n| 🥇 | [笔记标题链接]
作者名 粉丝数+ | 8w+
↑新增1w+ | 5w+
↑新增5000+ | 2w+
↑新增2000+ | 1w+
↑新增1000+ | 800+
↑新增500+ |\n\n回复\"查看更多\"可看剩余30条！✨\n\n**📊 七日热门笔记分析（Top50）**\n\n以下内容分析基于获取的全部数据（Top50）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征 | 实际效果 | 参考笔记 |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]
[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望 | 互动率提升50% | [笔记标题链接3]
[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查 | 收藏率提升55% | [笔记标题链接5]
[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力 | 曝光率提升40% | [笔记标题链接7]
[笔记标题链接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| 最高点赞 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n\n**📁 HTML文件包**\n\n```\n\n**订阅服务（是否需要订阅小红书七日热门笔记推荐？）**\n1. 每日19:30-推送小红书七日热门笔记TOP50\n2. 暂不需要-仅本次查询\n\n请回复数字或\"取消\"。\n\n## 使用示例\n\n### 示例1：关键词查询冷门爆款（数据=50条）\n- **场景/输入**：\"帮我查一下睫毛膏相关的爆款笔记\"\n- **执行流程**：\n 1. 匹配分类：睫毛膏 → 化妆美容\n 2. 查询化妆美容分类，返回50条数据\n 3. 实时热榜表格展示TOP1-20（与HTML页面保持一致）\n 4. 展示\"回复\"查看更多\"可看剩余30条！✨\"提示\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **最后生成HTML文件包（TOP1-20）**（与热榜表格数据完全一致）\n 7. **展示订阅服务**（提供每日19:30推送选项）\n\n### 示例2：泛查询热门内容（数据=30条）\n- **场景/输入**：\"最近小红书有什么热门内容\"\n- **执行流程**：\n 1. 使用\"综合全部\"分类\n 2. 查询后返回30条数据\n 3. 实时热榜表格展示TOP1-20（与HTML页面保持一致）\n 4. 展示\"回复\"查看更多\"可看剩余10条！✨\"提示\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **最后生成HTML文件包（TOP1-20）**（与热榜表格数据完全一致）\n 7. **展示订阅服务**（提供每日19:30推送选项）\n\n### 示例3：数据不足20条（数据=15条）\n- **场景/输入**：\"查询某个冷门分类\"\n- **执行流程**：\n 1. 匹配对应分类\n 2. 查询后返回15条数据\n 3. 实时热榜表格展示TOP1-15（全部数据，与HTML页面保持一致）\n 4. 不展示\"查看更多\"提示（数据未超过20条）\n 5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）\n 6. **最后生成HTML文件包（TOP1-15）**（与热榜表格数据完全一致）\n 7. **展示订阅服务**（提供每日19:30推送选项）\n\n### 示例4：查看更多内容\n- **场景/输入**：用户回复\"查看更多\"\n- **执行流程**：\n 1. 实时热榜表格展示TOP21-实际数据末尾（延续之前的数据）\n 2. **最后重新生成HTML文件包（TOP1-实际数据末尾）**（完整数据，覆盖之前的文件）\n\n## 资源索引\n- **脚本**：见 [scripts/xhs_weekly_fetcher.py](scripts/xhs_weekly_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- 数据每日19:00更新昨天的榜单\n- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含实时热榜（更新时间）+ 七日热门笔记分析 + HTML文件包 + 订阅服务\n - 🔥 实时热榜（必须包含更新时间）\n - 📊 七日热门笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\n - 📁 HTML文件包（必须输出实际文件，禁止只输出文件路径）\n - 订阅服务（提供每日19:30推送选项）\n - **禁止输出遗漏，禁止胡乱输出，必须严格按照此4项内容输出**\n- **输出格式要求（强制）**：\n - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\n - **禁止输出文件**：除HTML文件包外，禁止输出任何其他文件（如CSV、JSON、TXT等）\n - **输出顺序**：严格按照实时热榜 → 七日分析 → HTML文件包 → 订阅服务的顺序执行，禁止混乱输出\n- **输出顺序（严格按此顺序执行，禁止混乱输出）**：\n 1. **🔥 实时热榜**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）\n 2. **📊 七日热门笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）\n 3. **📁 HTML文件包**（必须最后执行，七日分析后立即执行，不等待任何用户回复，必须输出实际文件）\n 4. **订阅服务**（必须在HTML文件包之后展示，提供每日19:30推送小红书七日热门笔记TOP50的订阅选项）\n- **HTML文件包输出要求（强制）**：\n - 必须在所有内容输出完成后最后输出，不得提前或插入其他内容之前\n - **禁止只输出文件路径，必须输出实际HTML文件包**\n - **禁止折叠输出**\n - **PDF和图片导出内容一定是正确的**\n - 不需要等待任何流程\n- **订阅服务输出要求（强制，必须执行）**：\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- 七日分析标题后显示\"以下内容分析基于获取的全部数据（Top{数据条数}）进行~\"\n- 分析内容从创作者视角出发，提供可执行建议\n```\n\nFile v1.0.1:_skillhub_meta.json\n\n{\n \"name\": \"xhs-weekly-ranking\",\n \"installedAt\": 1777463601172,\n \"source\": \"import\"\n}\n\nArchive v1.0.0: 6 files, 31509 bytes\n\nFiles: _skillhub_meta.json (88b), references/core_workflow.md (31900b), scripts/gen_xhs_html.py (31516b), scripts/xhs_weekly_fetcher.py (26965b), SKILL.md (8013b), _meta.json (137b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: xhs-weekly-ranking\ndescription: 获取小红书平台爆款内容榜单，支持按分类查询热门笔记；当用户需要查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感时使用\n---\n\n# 小红书爆款内容榜单获取\n\n触发本技能并需要执行完整流程时，**必须先读取**与本技能同目录下的 `references/core_workflow.md`，并**完整遵循**其中的触发规则、术语规范、数据来源约束、操作步骤、自检清单与注意事项。脚本路径相对于技能目录：`scripts/xhs_weekly_fetcher.py`。\n\n---\n\n## 简介\n\n小红书七日爆款内容榜单助手是一款专为内容创作者和营销运营人员设计的智能工具，帮助用户实时追踪小红书平台各领域的热门笔记数据。\n\n通过简单的关键词查询，你可以：\n\n- 📊 获取往前7天的热门笔记TOP50榜单，解决「找爆文效率低」的痛点\n- 📈 智能拆解爆款标题规律、内容特征、数据表现，解决「拆规律凭感觉」的痛点\n- 🔔 支持每日19:30定时推送订阅，大幅降低信息差，放大内容创作收益\n\n适用于品牌方、MCN 机构、自媒体从业者、内容运营等需要监测小红书热门趋势的场景。\n\n---\n\n## 功能特性\n\n### 🎯 核心功能\n\n- **📊 实时热榜获取：** 支持按关键词自动匹配25个垂直分类，获取往前7天热门笔记TOP50，含互动数/点赞/评论/收藏/分享及新增数据\n- **📈 七日热门笔记分析：** 自动生成热门内容分析、爆款标题分析、最高数据作品分析三大模块，从创作者视角提供可执行建议\n- **📁 HTML可视化文件：** 一键生成可独立打开的HTML页面，支持链接跳转、导出图片和PDF，方便汇报与存档\n- **🔔 订阅推送服务：** 支持每日19:30自动推送小红书七日热门笔记TOP50，无需手动重复查询\n\n### ✨ 特色亮点\n\n- **🏷️ 全分类覆盖：** 支持综合全部、化妆美容、时尚穿搭、美味佳肴等25个主流内容分类查询\n- **🔍 智能分类匹配：** 输入关键词自动匹配对应分类（如\"睫毛膏\"→化妆美容），无需手动选择\n- **⏰ 灵活日期适配：** 支持指定日期查询，未指定时自动按19:00更新规则判断查询日期\n- **📄 多格式输出：** Markdown表格 + HTML可视化文件双格式，无论自用还是做汇报都能用\n- **⚡️ 无额外门槛：** 无需小红书账号、无需API密钥，安装依赖即可使用\n\n---\n\n## 使用指南\n\n### 基础使用\n\n#### 1. 发起查询\n\n告诉工具你要查询的关键词或分类（未指定分类则自动匹配，未指定日期则按19:00规则判断）：\n\n> 用户：帮我查一下睫毛膏相关的爆款笔记\n>\n> 助手：已匹配\"化妆美容\"分类，查询到50条热门笔记，随后输出实时热榜TOP20 + 七日分析 + HTML文件包 + 订阅选项\n\n#### 2. 查看更多\n\n默认输出TOP20内容，输入「查看更多」即可获取剩余数据：\n\n> 用户：查看更多\n>\n> 助手：为你展示TOP21-50的剩余30条热门笔记，并重新生成包含完整数据的HTML文件\n\n#### 3. 订阅推送\n\n回复对应数字即可开通每日推送：\n\n> 用户：1\n>\n> 助手：已为你开通小红书七日热门笔记订阅，每日19:30将推送当日TOP50榜单到你的消息栏\n\n### 高级使用\n\n#### 1. 指定日期查询\n\n> 用户：查2026-04-20美妆类爆款笔记\n\n#### 2. 泛查询热门内容\n\n> 用户：最近小红书有什么热门内容\n\n#### 3. 取消订阅\n\n> 用户：取消订阅\n\n### 常用命令速查\n\n| 命令 | 功能 |\n| --------------------- | ---------------------------- |\n| `查[关键词]爆款` | 查询指定关键词的爆款笔记榜单 |\n| `查[日期] [分类]爆款` | 查询指定日期/分类的爆文榜单 |\n| `查看更多` | 展示剩余数据（TOP21-末尾） |\n| `订阅` | 开通每日19:30爆款推送 |\n| `取消订阅` | 关闭每日推送服务 |\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 需求 | 使用方式 | 预期收益 |\n| ----------------------- | ------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------- |\n| 🎨 内容创作者找爆款灵感 | 美妆博主 | 不知道做什么内容能爆，想快速找到对标参考 | ① 输入\"化妆美容\"查询七日热门榜单，拆解标题规律和内容特征
② 查看最高数据作品分析，了解封面设计和内容价值的关键要素
③ 订阅每日推送，持续追踪热门趋势变化 | 最快1周找到适合自己的爆文模版，内容产出效率提升3倍 |\n| 📢 品牌运营追踪热点方向 | 快消品牌小红书运营 | 紧跟平台最新热点，做符合用户喜好的营销内容 | ① 按周查询对应分类的综合爆款，提取近期热门关键词和内容形式
② 利用HTML文件导出PDF，制作周报汇报给团队 | 内容点击率提升40%，推广成本降低25% |\n| 🔍 MCN 挖掘潜力账号 | MCN 内容星探 | 发现高互动的新账号，降低签约成本 | ① 每天查看各分类热门榜单，筛选同领域高互动的新账号
② 结合七日分析中的\"最高互动作品\"，评估账号成长性 | 新人签约成本降低60%，账号孵化成功率提升50% |\n\n---\n\n---\n\n## 常见问答\n\n### 安装相关问题\n\n**Q1: 安装依赖时报错怎么办？**\n\nA: 请检查以下几点：\n\n1. 确认 Python 版本 >= 3.8（运行 `python --version` 查看）\n2. 尝试使用国内镜像源安装：`pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple`\n3. 如遇到权限问题，尝试加上 `--user` 参数\n\n**Q2: 需要配置小红书账号或API Key吗？**\n\nA: 不需要。本技能使用小红书公开数据接口，无需账号登录或API密钥，安装依赖即可使用。\n\n---\n\n### 使用相关问题\n\n**Q3: 数据多久更新一次？**\n\nA: 每日19:00更新昨天的榜单数据。如果当前时间未到19:00，则查询的是前天数据；19:00之后查询的为昨日数据。\n\n**Q4: 支持哪些分类查询？**\n\nA: 支持共25个垂直分类：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼。\n\n**Q5: 为什么有些分类数据不足50条？**\n\nA: 部分垂直分类内容热度较低，可能返回少于50条数据，这是正常现象。数据不足20条时不会展示\"查看更多\"提示。\n\n---\n\n### 故障排除\n\n**Q6: HTML文件生成失败怎么办？**\n\nA: 请按以下步骤排查：\n\n1. 检查是否有数据返回（先确认热榜表格正常输出）\n2. 确认 `scripts/gen_xhs_html.py` 文件存在且未被修改\n3. 尝试手动执行：`python scripts/gen_xhs_html.py --keyword \"测试\" --top 20`\n\n**Q7: 分享字段数据为空或错误怎么办？**\n\nA: 分享字段使用 `AnaAddBean.useShareCount`（累计分享数）和 `AnaAddBean.addShareCount`（新增分享数），如果数据加载失败或字段缺失，系统会自动重新调用脚本尝试，直到字段数据完整。\n\n---\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n \"slug\": \"xhs-weekly-ranking\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1777464771970\n}\n\nFile v1.0.0:references/core_workflow.md\n\n## 任务目标\n\n- 本 Skill 用于：获取小红书平台爆款内容榜单数据\n- 能力包含：\n - 实时热榜数据获取（按分类查询）\n - 七日热门笔记智能分析\n - 冷门爆款笔记挖掘（关键词匹配分类）\n - 订阅服务（每日定时推送）\n- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析\n\n## 数据接口更新规则\n\n- **更新时间**：每天19:00更新昨天的榜单数据\n- **数据范围**：往前7天的热门笔记TOP50\n- **分类覆盖**：25个垂直领域分类\n\n## 输出规范（强制执行）\n\n**数据一致性要求（重要）**：\n\n- 实时热榜表格与HTML页面数据必须完全一致（相同排序、相同内容）\n- 两个脚本使用相同的API接口和排序逻辑（互动数优先，备用计算：点赞+收藏*2+评论*3+分享\\*5）\n- 禁止胡乱渲染或使用不同数据源\n\n**输出内容必须严格包含以下三部分，禁止遗漏或胡乱输出：**\n\n- **实时热榜（更新时间）**：必须直接输出，禁止折叠\n- **七日热门笔记分析**：必须直接输出，禁止折叠\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- 标题格式：**🔥 【{分类名称}】实时热榜 （更新时间：YYYY-MM-DD HH:MM:SS）**（标题整体加粗）\n- 标题示例：**🔥 【化妆美容】实时热榜 （更新时间：2025-01-15 10:30:00）**\n\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\n\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\n| :--: | :------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\n| 🥇 | [笔记标题链接]
[作者名链接] 粉丝数+ | 22w+
↑新增23w+ | 22w+
↑新增21w+ | 893
↑新增21w+ | 1w+
↑新增21w+ | 1w+
↑新增21w+ |\n| 🥈 | [笔记标题链接]
[作者名链接] 粉丝数+ | 20w+
↑新增18w+ | 18w+
↑新增16w+ | 756
↑新增18w+ | 8k+
↑新增16w+ | 900+
↑新增16w+ |\n| 🥉 | [笔记标题链接]
[作者名链接] 粉丝数+ | 18w+
↑新增15w+ | 15w+
↑新增13w+ | 621
↑新增15w+ | 7k+
↑新增13w+ | 800+
↑新增13w+ |\n\n**字段详细说明**：\n\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\n- **笔记信息**：\n - 第一行：笔记标题（可点击跳转）\n - 第二行：[作者名链接] 粉丝数+（作者名可点击跳转到作者主页，字号与标题一样大）\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- 单元格内使用 `
` 换行显示累计数据和新增数据\n- 累计数据：大于等于1万显示\"数字w+\"，小于1万显示纯数字（不显示\"累计：\"文案）\n- 新增数据格式：累计数据
↑新增数字w+ 或 ↑新增纯数字（\"↑新增\"字号小一号，正常文字颜色）\n- 每个数据单元格占两行：第一行累计数据，第二行\"↑新增数值\"（不换行）\n- \"↑新增\"文案字号比累计数据小一号\n- \"↑新增数值\"使用正常文字颜色显示，与累计数据在同一行\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- 示例：**📊 七日热门笔记分析（Top50）**\n\n以下内容分析基于获取的全部数据（Top{数据条数}）进行~\n\n**💡热门内容分析**\n\n| 内容分类 | 内容特征 | 实际效果 | 参考笔记 |\n| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |\n| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]
[笔记标题链接2] |\n| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望 | 互动率提升50% | [笔记标题链接3]
[笔记标题链接4] |\n| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查 | 收藏率提升55% | [笔记标题链接5]
[笔记标题链接6] |\n| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力 | 曝光率提升40% | [笔记标题链接7]
[笔记标题链接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| 最高点赞 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高收藏 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高评论 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n| 最高互动 | 风格：具体风格描述
特征：详细特征说明
数据效果：效果数据
建议：具体建议 | [笔记标题链接] |\n\n### 第三部分：HTML文件包（必须最后输出）\n\n**强制要求（必须严格遵守）**：\n\n- HTML文件包必须在所有内容输出完成后最后输出，不得提前或插入其他内容\n- 不需要等待用户回复，七日分析输出后立即执行\n- 这是输出的最后一步，必须在实时热榜、七日分析之后\n- **禁止只输出文件路径，必须输出实际HTML文件包**\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","readmeExcerpt":"Skill: 小红书七日爆款笔记 Owner: if530770 Summary: 专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送。创作者可查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-06-05T03:40:04.132Z | user xhs-weekly-ranking 1.0.5 - No changes detected compared to the previous version. - All features, documentation, and behavior remain consistent with the previous release. v1.0.4 | 2026-06-05T03:39:00.53","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# 进入 Skill 目录\ncd xiaohongshu-weeklytop\n\n# 获取榜单数据（JSON 输出）\npython scripts/xhs_weekly_fetcher.py --keyword \"睫毛膏\" --top_n 50\n\n# 生成 HTML 报告（从已获取的数据文件读取，不再调用API）\npython scripts/gen_xhs_html.py --data_file \"xhs_data.json\" --category \"化妆美容\" --top 20"},{"language":"bash","snippet":"python scripts/xhs_weekly_fetcher.py --category \"时尚穿搭\" --top_n 50\npython scripts/gen_xhs_html.py --category \"时尚穿搭\" --top 50"},{"language":"bash","snippet":"python scripts/gen_xhs_html.py --data_file \"xhs_data.json\" --category \"穿搭\" --top 20 --output ./reports/小红书七日爆款笔记_穿搭.html"},{"language":"text","snippet":"xiaohongshu-weeklytop/\n├── SKILL.md # Skill 入口与使用说明（本文件）\n├── references/\n│ └── core_workflow.md # 核心执行流程与输出规范（Agent 必读）\n└── scripts/\n ├── xhs_weekly_fetcher.py # 榜单数据获取脚本\n └── gen_xhs_html.py # HTML 可视化报告生成脚本"},{"language":"bash","snippet":"# 获取榜单数据（固定 top_n=50）\npython scripts/xhs_weekly_fetcher.py --keyword \"睫毛膏\" --top_n 50\n\n# 首次生成 HTML（top=20）\npython scripts/gen_xhs_html.py --keyword \"睫毛膏\" --top 20\n\n# 查看更多后生成完整 HTML（top=50）\npython scripts/gen_xhs_html.py --keyword \"睫毛膏\" --top 50\n\n# 指定日期与分类\npython scripts/xhs_weekly_fetcher.py --rank_date \"2026-04-15\" --category \"时尚穿搭\" --top_n 50\npython scripts/gen_xhs_html.py --rank_date \"2026-04-15\" --category \"时尚穿搭\" --top 20"},{"language":"text","snippet":"技能还支持以下功能：\n1️⃣ 支持订阅小红书七日爆款笔记。订阅后将在每日19:30为您推送小红书七日爆款笔记TOP50。直接回复\"订阅或 1\"即可订阅相关内容。\n2️⃣ 可生成小红书风格的html文件包。支持导出PDF，方便阅读、保存和分享。"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: xiaohongshu-weeklytop\r\ndescription: 专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送。创作者可查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感。\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- 支持关键词自动匹配 25 个垂直分类，降低查询门槛\r\n\r\n**适用对象**：品牌方、MCN 机构、小红书博主、内容运营、增长团队\r\n\r\n**技术基础**：Python 3 + RedFox 小红书数据 API，数据每日 19:00 更新\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n| 功能 | 说明 |\r\n|------|------|\r\n| 📊 近日热榜查询 |按分类查询热门笔记，覆盖美妆、穿搭、美食、家居等25个垂直领域，快速掌握当下流量风向 |\r\n| 📈 七日热门分析 | 基于近7天各分类TOP50热门笔记的深度洞察，从流行趋势、热门话题深度分析、实用价值等维度拆解爆款共性 |\r\n| 🔍 形式规律对比 | 自动识别高质量封面、情绪共鸣点、实用价值、紧跟热点等爆款要素，提炼可复用的创作范式 |\r\n| 📁 创作建议输出 | 基于分析结果，提供可执行的选题方向、差异化策略、高维作品拆解建议 |\r\n| 🔔 订阅推送 | 定时推送最新趋势分析报告，持续跟踪赛道热点，不错过任何一个流量机会 |\r\n\r\n### ✨ 特色亮点\r\n\r\n- **⚡ 数据一致**：七日爆款笔记表格与 HTML 页面使用相同数据源与排序逻辑，排名完全一致\r\n- **📱 分页展示**：首次展示 TOP20，回复「查看更多」可加载剩余数据\r\n- **🎯 冷门爆款**：聚焦低粉高互动笔记，适合挖掘可对标样本\r\n- **🔒 零配置调用**：Agent 执行时自动判断查询日期，无需手动维护\r\n\r\n---\r\n\r\n## 鉴权\r\n\r\n### 获取 API Key\r\n\r\n1. 访问 [红狐Hub 官网](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\r\n若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若不会配置，Agent 可主动帮用户设置：\r\n\r\n- **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效\r\n- **Windows**：使用 `[Environment]::SetEnvironmentVariable(\"REDFOX_API_KEY\", \"<值>\", \"User\")` 设置用户级永久环境变量（需重启终端生效）\r\n\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- Python 3.8+\r\n- 网络可访问 `redfox.hk` 数据 API\r\n- 已安装 `requests` 库（`pip install requests`）\r\n- 已配置 `REDFOX_API_KEY` 环境变量（参见上方「鉴权」章节）\r\n\r\n### 安装方式\r\n\r\n#### 方式一：WorkBuddy / Cursor Skills（推荐）\r\n\r\n1. 将本 Skill 目录放置于 Skills 工作区（如 `~/.workbuddy/skills/xiaohongshu-weeklytop`）\r\n2. 确保目录结构完整：`SKILL.md`、`references/`、`scripts/`\r\n3. 在对话中直接触发，例如：\r\n - 「帮我查一下睫毛膏相关的爆款笔记」\r\n - 「最近小红书有什么热门内容」\r\n - 「查看穿搭领域七日热榜」\r\n\r\n#### 方式二：命令行独立运行\r\n\r\n```bash\r\n# 进入 Skill 目录\r\ncd xiaohongshu-weeklytop\r\n\r\n# 获取榜单数据（JSON 输出）\r\npython scripts/xhs_weekly_fetcher.py --keyword \"睫毛膏\" --top_n 50\r\n\r\n# 生成 HTML 报告（从已获取的数据文件读取，不再调用API）\r\npython scripts/gen_xhs_html.py --data_file \"xhs_data.json\" --category \"化妆美容\" --top 20\r\n```\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n> **执行约束（强制）**：Agent 执行本 Skill 时，**必须先完整阅读并严格遵循** [references/core_workflow.md](references/core_workflow.md) 中的调用 Key 说明、输出规范、操作步骤与注意事项。以下为基础用法摘要，详细流程以核心工作流文档为准。\r\n\r\n### 基础使用\r\n\r\n#### 1. 关键词查询爆款\r\n\r\n> **用户**：帮我查一下睫毛膏相关的爆款笔记\r\n>\r\n> **助手**：自动匹配「化妆美容」分类 → 获取 TOP50 数据 → 输出七日爆款笔记 TOP20 → 七日分析 → 功能询问（HTML+订阅）\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> **助手**：延续输出 TOP21 至末尾 → 如用户选择生成 HTML，从已获取数据文件读取完整数据重新生成\r\n\r\n### 高级使用\r\n\r\n#### 1. 指定日期查询\r\n\r\n> **用户**：查看 2026-04-15 穿搭领域热榜\r\n>\r\n> **助手**：使用 `--rank_date \"2026-04-15\"` 查询指定日期数据\r\n\r\n#### 2. 直接指定分类\r\n\r\n```bash\r\npyt"},{"path":"README.md","content":"# 小红书七日爆款笔记 / xiaohongshu-weeklytop\r\n\r\n---\r\n\r\n## 简介\r\n\r\n专为内容创作者与运营人员设计的小红书七日爆款笔记工具，基于近 7 天热门笔记 TOP50 深度洞察，一键获取垂直领域热榜与创作分析。\r\n\r\n**核心价值**\r\n\r\n- 解决「不知道当下什么内容火、为什么火」的选题难题，7 天维度比单日更稳定可信\r\n- 实时热榜 + 智能分析 + 可导出 HTML 报告，支撑复盘与创作决策\r\n- 支持关键词自动匹配 25 个垂直分类，降低查询门槛\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- **近日热榜查询**：按分类查询近 7 天热门笔记，覆盖 25 个垂直领域，快速掌握当下流量风向\r\n- **七日热门分析**：从流行趋势、热门话题、实用价值等维度深度拆解爆款共性\r\n- **形式规律对比**：自动识别高质量封面、情绪共鸣点、实用价值、紧跟热点等爆款要素\r\n- **创作建议输出**：提供可执行的选题方向、差异化策略与高维作品拆解建议\r\n- **订阅推送**：每日 19:30 定时推送最新趋势分析报告\r\n\r\n### 特色亮点\r\n\r\n- 热榜表格与 HTML 页面使用相同数据源与排序逻辑，排名完全一致\r\n- 首次展示 TOP20，回复「查看更多」可加载剩余数据，HTML 同步更新为全量\r\n- 聚焦低粉高互动笔记，适合挖掘可对标的真实爆款样本\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/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-15 穿搭领域热榜` | 指定日期获取对应数据 |\r\n| 加载更多 | 回复「查看更多」 | 延续输出 TOP21 至末尾，HTML 重新生成为完整版本 |\r\n| 订阅每日推送 | 输出完成后回复 `1` | 开通每日 19:30 七日爆款笔记推送 |\r\n\r\n### 输出示例\r\n\r\n每次查询固定四段输出：近日热榜 TOP20 → 七日爆款分析（趋势 + 话题 + 形式规律）→ HTML 可视化页面 → 订阅服务选项。\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景 | 角色 | 示例问法 | 收益 |\r\n| ------------ | --------------- | --------------------------------- | ------------------------------------------------ |\r\n| 博主选题灵感 | 小红书新人博主 | `查一下护肤领域七日热榜` | 快速找到可借鉴的选题方向，降低冷启动试错成本 |\r\n| 品牌竞品监测 | 品牌营销经理 | `查口红相关的七日爆款并导出 HTML` | 掌握品类内容风向，优化投放与种草策略 |\r\n| 达人运营复盘 | MCN 运营人员 | `查穿搭领域七日热榜并订阅推送` | 拆解爆款标题类型，持续跟踪热点为达人提供选题参考 |\r\n| 数据洞察汇报 | 增长 / 数据分析 | `查美食类完整 TOP50 并导出 HTML` | 获得可分享、可归档的数据报告，支撑周报与策略会 |"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n \"slug\": \"xhs-weekly-ranking\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1780630804132\n}"},{"path":"references/core_workflow.md","content":"## 任务目标\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- **数据范围**：往前7天的热门笔记TOP50\r\n- **分类覆盖**：25个垂直领域分类\r\n\r\n## 调用 Key 说明\r\n\r\nAgent 调用脚本时必须按以下参数规范执行：\r\n\r\n| 参数 | 适用脚本 | 必填 | 说明 |\r\n|------|----------|------|------|\r\n| `--keyword` | 两者 | 推荐 | 用户输入关键词，用于自动匹配分类 |\r\n| `--category` | 两者 | 否 | 直接指定分类名（25 个分类之一），与 `--keyword` 二选一或配合使用 |\r\n| `--rank_date` | 两者 | 否 | 查询日期，格式 `YYYY-MM-DD`；未指定则按日期判断规则自动推断 |\r\n| `--top_n` | `xhs_weekly_fetcher.py` | 否 | 返回条数，执行时固定传 `50` |\r\n| `--top` | `gen_xhs_html.py` | 否 | HTML 展示条数：首次输出 `20`，用户「查看更多」后传 `50` 或实际数据条数 |\r\n| `--output` | `gen_xhs_html.py` | 否 | HTML 输出文件路径，未指定则使用脚本默认路径 |\r\n| `--list_categories` | `xhs_weekly_fetcher.py` | 否 | 列出所有可用分类（调试时使用） |\r\n\r\n**调用示例**：\r\n\r\n```bash\r\n# 获取榜单数据（固定 top_n=50）\r\npython scripts/xhs_weekly_fetcher.py --keyword \"睫毛膏\" --top_n 50\r\n\r\n# 首次生成 HTML（top=20）\r\npython scripts/gen_xhs_html.py --keyword \"睫毛膏\" --top 20\r\n\r\n# 查看更多后生成完整 HTML（top=50）\r\npython scripts/gen_xhs_html.py --keyword \"睫毛膏\" --top 50\r\n\r\n# 指定日期与分类\r\npython scripts/xhs_weekly_fetcher.py --rank_date \"2026-04-15\" --category \"时尚穿搭\" --top_n 50\r\npython scripts/gen_xhs_html.py --rank_date \"2026-04-15\" --category \"时尚穿搭\" --top 20\r\n```\r\n\r\n## 输出规范（强制执行）\r\n\r\n**数据一致性要求（重要）**：\r\n\r\n- 七日爆款笔记表格与HTML页面数据必须完全一致（相同排序、相同内容）\r\n- 两个脚本使用相同的API接口和排序逻辑（互动数优先，备用计算：点赞+收藏*2+评论*3+分享\\*5）\r\n- 禁止胡乱渲染或使用不同数据源\r\n\r\n**输出内容必须严格包含以下三部分，禁止遗漏或胡乱输出：**\r\n\r\n- **七日爆款笔记（更新时间）**：必须直接输出，禁止折叠\r\n- **七日热门笔记分析**：必须直接输出，禁止折叠\r\n- **功能询问（HTML+订阅）**：必须在分析之后立即输出，禁止跳过\r\n\r\n**输出格式要求（强制执行）**：\r\n\r\n- **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出\r\n- **禁止输出文件**：除HTML文件包外，禁止输出任何其他文件（如CSV、JSON、TXT等）\r\n- **HTML文件包必须输出实际文件，禁止只输出文件路径，禁止折叠输出**\r\n\r\n**输出顺序（严格按此顺序执行，禁止混乱输出，禁止遗漏）**：\r\n\r\n1. 🔥 七日爆款笔记（含更新时间）\r\n2. 📊 七日热门笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）\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- 标题格式：**🔥 【{分类名称}】七日爆款笔记 （更新时间：YYYY-MM-DD HH:MM:SS）**（标题整体加粗）\r\n- 标题示例：**🔥 【化妆美容】七日爆款笔记 （更新时间：2025-01-15 10:30:00）**\r\n\r\n- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：\r\n\r\n| 排名 | 笔记信息 | 互动数 | 点赞 | 评论 | 收藏 | 分享 |\r\n| :--: | :------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |\r\n| 🥇 | [笔记标题链接]
[作者名链接] 粉丝数+ | 22w+
↑新增23w+ | 22w+
↑新增21w+ | 893
↑新增21w+ | 1w+
↑新增21w+ | 1w+
↑新增21w+ |\r\n| 🥈 | [笔记标题链接]
[作者名链接] 粉丝数+ | 20w+
↑新增18w+ | 18w+
↑新增16w+ | 756
↑新增18w+ | 8k+
↑新增16w+ | 900+
↑新增16w+ |\r\n| 🥉 | [笔记标题链接]
[作者名链接] 粉丝数+ | 18w+
↑新增15w+ | 15w+
↑新增13w+ | 621
↑新增15w+ | 7k+
↑新增13w+ | 800+
↑新增13w+ |\r\n\r\n**字段详细说明**：\r\n\r\n- **排名**：1-3名显示🥇🥈🥉，其余显示数字\r\n- **笔记信息**：\r\n - 第一行：笔记标题（可点击跳转）\r\n - 第二行：[作者名链接] 粉丝数+（作者名可点击跳转到作者主页，字号与标题一样大）\r\n- **互动数**：\r\n - 第一行：累计互动数（格式：数字w"},{"path":"README.en.md","content":"# Xiaohongshu Weekly Viral Notes / xiaohongshu-weeklytop\r\n\r\n---\r\n\r\n## Introduction\r\n\r\nA Xiaohongshu 7-day viral notes tool designed for creators and operators — one query delivers vertical category hot rankings and deep analysis based on the TOP50 notes from the past 7 days.\r\n\r\n**Core Value**\r\n\r\n- Solves the \"I don't know what's trending or why\" problem in topic selection — a 7-day window is more stable and reliable than a single day\r\n- Real-time hot rankings + smart analysis + exportable HTML reports, supporting review sessions and creative decisions\r\n- Keyword auto-matching across 25 vertical categories lowers the barrier to query\r\n\r\n**Who It's For**\r\n\r\n- ✍️ Xiaohongshu creators — understand what content tends to go viral in your track over the past week, and find replicable topic directions\r\n- 📢 Brand marketing managers — monitor vertical category viral content trends to optimize placements and seeding strategies\r\n- 🏢 MCN operations staff — provide track hot topic references for managed creators to shorten topic discussion cycles\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Recent hot rankings**: Query the past 7 days' hot notes by category, covering 25 vertical tracks to quickly grasp current traffic direction\r\n- **7-day trend analysis**: Deep insights from multiple dimensions — popular trends, hot topics, practical value — breaking down viral content commonalities\r\n- **Format pattern comparison**: Auto-identifies viral elements like high-quality covers, emotional resonance, practical value, and trend alignment\r\n- **Creative suggestions**: Delivers actionable topic directions, differentiation strategies, and high-performing post breakdowns\r\n- **Subscription push**: Daily 19:30 scheduled delivery of the latest trend analysis reports\r\n\r\n### Highlights\r\n\r\n- Hot ranking tables and HTML pages share the same data source and sort logic — rankings are fully consistent\r\n- First display shows TOP20; reply \"load more\" to get remaining data, HTML updates to full version\r\n- Focused on low-follower high-engagement notes, ideal for finding authentic benchmark viral samples\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 "}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送。创作者可查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感。 Skill: 小红书七日爆款笔记 Owner: if530770 Summary: 专注于小红书平台的内容趋势分析，基于近7天热门笔记TOP50深度洞察，支持25个垂直领域分类查询、冷门爆款挖掘及每日订阅推送。创作者可查询小红书热门内容、分析爆款笔记、了解各领域趋势或获取创作灵感。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-06-05T03:40:04.132Z | user xhs-weekly-ranking 1.0.5 - No changes detected compared to the previous version. - All features, documentation, and behavior remain consistent with the previous release. v1.0.4 | 2026-06-05T03:39:00.53","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1054,"uniquenessScore":55,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T18:43:03.058Z","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-11T18:43:03.058Z","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-12T05:32:14.095Z","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"}]}}}