{"id":"1160963c-949f-47e3-8d0c-2a5e95031fad","entityType":"agent","slug":"clawhub-devinchen2014-xhs-content-research","name":"小红书内容研究","canonicalUrl":"https://www.xpersona.co/agent/clawhub-devinchen2014-xhs-content-research","canonicalPath":"/agent/clawhub-devinchen2014-xhs-content-research","generatedAt":"2026-10-10T21:43:21.723Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T18:27:57.141Z","emptyReason":null},"description":"面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。 Skill: 小红书内容研究 Owner: devinchen2014 Summary: 面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。 Tags: latest:0.1.10 Version history: v0.1.10 | 2026-08-14T11:01:32.277Z | user Clarify XHS search parameter naming for MCP tool calls. v0.1.9 | 2026-08-11T14:01:06.728Z | user Refresh ClawHub mirror to match current SkillHub workflow. v0.1.8 | 2026-08-11T02:38:26.479Z | user M","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s1777wgr53fwsangwq5485w3jd85913j:xhs-content-research","sourceUrl":"https://clawhub.ai/devinchen2014/xhs-content-research","homepage":"https://clawhub.ai/devinchen2014/skills/xhs-content-research","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/devinchen2014/xhs-content-research","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/devinchen2014/skills/xhs-content-research","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":62,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。 Skill: 小红书内容研究 Owner: devinchen2014 Summary: 面向内容运营、品牌调研和创作者的小"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T18:27:57.141Z","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-10T18:27:57.141Z","emptyReason":null},"stars":null,"forks":null,"downloads":1296,"packageName":null,"latestVersion":"0.1.10","tractionLabel":"1.3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T18:27:57.141Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T18:27:57.141Z","lastCrawledAt":"2026-10-10T18:27:57.141Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T18:27:57.141Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.10","createdAt":"2026-08-14T11:01:32.277Z","changelog":"Clarify XHS search parameter naming for MCP tool calls.","fileCount":3,"zipByteSize":5228},{"version":"0.1.9","createdAt":"2026-08-11T14:01:06.728Z","changelog":"Refresh ClawHub mirror to match current SkillHub workflow.","fileCount":3,"zipByteSize":5247},{"version":"0.1.8","createdAt":"2026-08-11T02:38:26.479Z","changelog":"Mirror the proven SkillHub content-research workflow on ClawHub.","fileCount":3,"zipByteSize":5299},{"version":"0.1.7","createdAt":"2026-08-05T03:24:28.293Z","changelog":"同步 SocialDataX 多平台公开能力口径","fileCount":3,"zipByteSize":4496},{"version":"0.1.6","createdAt":"2026-07-29T10:50:48.962Z","changelog":"Refresh Skill batch handling and XHS parameter guidance.","fileCount":3,"zipByteSize":4682},{"version":"0.1.5","createdAt":"2026-07-29T09:59:36.958Z","changelog":"Refresh XHS parameter and bounded batch guidance.","fileCount":3,"zipByteSize":4593},{"version":"0.1.4","createdAt":"2026-07-20T11:29:17.713Z","changelog":"Refresh API Key guidance to the SocialDataX AI access page.","fileCount":3,"zipByteSize":4424},{"version":"0.1.3","createdAt":"2026-07-20T10:36:40.030Z","changelog":"Refresh API Key guidance to the SocialDataX AI access page.","fileCount":3,"zipByteSize":4518}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1777wgr53fwsangwq5485w3jd85913j:xhs-content-research","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-devinchen2014-xhs-content-research/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-xhs-content-research/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-xhs-content-research/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-xhs-content-research/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-xhs-content-research/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-xhs-content-research/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-10T21:43:21.721Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-xhs-content-research/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-xhs-content-research/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-xhs-content-research/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-xhs-content-research/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-10T18:27:57.141Z","emptyReason":null},"readme":"Skill: 小红书内容研究\n\nOwner: devinchen2014\n\nSummary: 面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\n\nTags: latest:0.1.10\n\nVersion history:\n\nv0.1.10 | 2026-08-14T11:01:32.277Z | user\n\nClarify XHS search parameter naming for MCP tool calls.\n\nv0.1.9 | 2026-08-11T14:01:06.728Z | user\n\nRefresh ClawHub mirror to match current SkillHub workflow.\n\nv0.1.8 | 2026-08-11T02:38:26.479Z | user\n\nMirror the proven SkillHub content-research workflow on ClawHub.\n\nv0.1.7 | 2026-08-05T03:24:28.293Z | user\n\n同步 SocialDataX 多平台公开能力口径\n\nv0.1.6 | 2026-07-29T10:50:48.962Z | user\n\nRefresh Skill batch handling and XHS parameter guidance.\n\nv0.1.5 | 2026-07-29T09:59:36.958Z | user\n\nRefresh XHS parameter and bounded batch guidance.\n\nv0.1.4 | 2026-07-20T11:29:17.713Z | user\n\nRefresh API Key guidance to the SocialDataX AI access page.\n\nv0.1.3 | 2026-07-20T10:36:40.030Z | user\n\nRefresh API Key guidance to the SocialDataX AI access page.\n\nv0.1.2 | 2026-07-20T08:14:08.982Z | user\n\nAdd balance recharge guidance to generated SocialDataX Skill.\n\nv0.1.1 | 2026-07-17T06:13:09.122Z | user\n\nRetry publication after 0.1.0 stayed pending.publication.\n\nv0.1.0 | 2026-07-17T04:10:54.536Z | user\n\nPublish ClawHub no-brand XHS content research scene entry.\n\nArchive index:\n\nArchive v0.1.10: 3 files, 5228 bytes\n\nFiles: skill-card.md (2297b), SKILL.md (7321b), _meta.json (140b)\n\nFile v0.1.10:SKILL.md\n\n---\nname: \"xhs-content-research\"\ndescription: \"面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"xhs-content-research\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"📌\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 小红书内容研究\n\n## 适用场景\n\n面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\n\n## 快速开始\n\n- 先给出当前 skill 支持的输入：关键词或选题方向。\n- 如果你只想先看样本，先取 1 页；要继续扩大，再按参数说明使用分页或 `--max-items`。\n- 你通常会得到：相关标题、作者或账号、链接或内容 ID，以及可继续追问的角度。\n\n## API Key 获取\n\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## 直接调用命令\n\n优先使用 direct CLI；能运行 shell 命令的 Agent 不需要额外配置 MCP server：\n\n```bash\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research\n\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research\n```\n\n## 参数说明\n\n搜索：\n- 必填：`--keyword `：内容研究主题；使用用户真实意图，去掉多余空格，并保持关键词聚焦。\n- 可选：`--sort-type `：可选排序参数；不传就使用默认排序。\n- 可选：`--note-type `：可选内容类型筛选；默认是 `all`。\n- 可选：`--publish-time-range `：可选发布时间筛选；默认是 `all`。\n- 可选：`--pages `：从当前起点继续获取并合并 N 页搜索结果；如果返回了 `next_page_token`，可继续续页。\n- 可选：`--max-items `：收集到 N 条搜索结果后停止。\n- 可选：`--since-days <1-365>`：只保留最近 N 天内公开 `publish_time` 落在范围内的搜索结果；搜索范围仍受 `--pages` 限制。\n\n通用：\n- 可选：`--page-token `：这是不透明的分页 token；第一页不要传。继续同一条搜索链路时，只能原样传回完整返回的 `next_page_token`，不能截断、改写、脱敏、重建，或用省略号替换中间内容。\n- 可选：`--pretty`：只影响输出格式，不改变实际请求结果。\n- 可选：`--source-client socialdatax-skills --source-platform clawhub --source-skill xhs-content-research`：这是当前 Agent Skill 的来源标记；按本 Skill 示例执行时保持这些值不变。\n\n## 输出建议\n\n优先输出可直接复盘的结果：相关样本和主要角度，并标出下一步可继续追问的问题。\n\n先把可见证据和你的判断分开写；当用户需要可追溯结论时，重点整理话题模式、内容角度、受众反馈、创作者定位和可引用样本。\n对于 XHS 搜索结果里的 `note_url`，无论是在最终回答、展示、引用、存储、输出还是转发时，都要保留完整原始 URL，包括其中的 `xsec_token` 查询参数；不要改写、截断、脱敏、重建，也不要只根据 `note_id` 去拼链接。\n对于 XHS `note_id`，要原样复制返回的完整 `note_id`；不要只传或只展示前缀。\n当用户要看最近话题时，优先使用 CLI 的 `--since-days 7`，或者按用户指定的天数窗口执行；不要把当前返回页范围说成全平台完整覆盖。\n\n## MCP 工具\n\n与上面 direct CLI 命令对应的 MCP 工具：\n\n- `xhs_search_notes`\n\n在 XHS 搜索场景中，调用 `xhs_search_notes` 时传 `keyword`，可选传 `page_token`、`sort_type`、`note_type` 和 `publish_time_range`。\n\n调用 `xhs_search_notes` 时不要传 `page`；第一页也不要传 `page_token`。\n只有在 `next_page_token` 非空时才继续翻页；并且在同一个关键词、排序、内容类型、发布时间范围和调用链路下，把完整返回的 `next_page_token` 原样作为 `page_token` 传回。\n\n小红书搜索参数命名提醒：direct CLI 使用 `--sort-type`、`--publish-time-range`、`--note-type`；MCP 工具 `xhs_search_notes` 使用 `sort_type`、`publish_time_range`、`note_type`。不要传 `sortType`、`publishTimeRange` 或 `noteType`。\n\n## 安全边界\n\n这是只读 skill。运行时使用用户环境变量中的 `SOCIALDATAX_API_KEY`；生成的 Skill 文件不包含 API Key。不会读取本地浏览器数据，也不会执行登录、发帖、点赞、评论或账号修改。\n\n## 示例结果\n\n- 示例展示格式，不代表固定字段：内容样本=标题/作者/链接或 ID；判断=相关原因和下一步。\n\n## 异常处理\n\n- 如果出现 SDK/依赖缺失、npm 网络、Node.js/npm/npx 不可用或执行权限错误：这是本地运行环境、依赖安装、网络或 AI 平台授权问题，不是 SocialDataX API Key 或业务数据返回错误；有权限时可自动安装或修复；需要网络或执行授权时提醒用户同意或完成授权；处理后继续原命令；不要改用公开网页搜索替代 SocialDataX 数据。\n- 非余额不足的网络或 API 异常：保留错误信息，检查 `SOCIALDATAX_API_KEY`、参数和链接格式后原样重试一次。\n- 如果返回 `insufficient_balance` 或“积分不足”：不要重复重试；把错误里的充值链接原样展示给用户，并提醒用户充值后继续执行刚才同一条命令。\n- 如果用户已经充值但仍提示余额不足：确认当前环境变量 `SOCIALDATAX_API_KEY` 是否来自刚充值的同一个账号；必要时重新复制官网后台的 API Key。\n- 分页中断：保留已取得的结果；重试仍失败：说明当前调用不可用，请用户补充或更换关键词、链接、ID 等输入后再重试。\n\n## 常见问题\n\n- 没结果：放宽关键词、减少限定，或换成更贴近用户表达的词。\n- 结果太多：补场景、人群、品牌、时间范围或账号名。\n- 调用失败：先确认 `SOCIALDATAX_API_KEY` 已配置；如果是 `insufficient_balance` 或“积分不足”，按错误里的充值链接充值后继续原命令，不要反复重试。\n- 担心账号安全：这是只读能力，不登录、不发帖、不点赞、不评论。\n- 想继续分析：把最相关的 1-3 条结果发回来，继续缩小范围。\n\nFile v0.1.10:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"xhs-content-research\",\n \"version\": \"0.1.10\",\n \"publishedAt\": 1786705292277\n}\n\nFile v0.1.10:skill-card.md\n\n## Description:\n\n面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[devinchen2014](https://clawhub.ai/user/devinchen2014)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nContent operators, brand researchers, and creators use this skill to search Xiaohongshu/RedNote content by keyword, compare competing content, observe trends, and organize research samples for follow-up analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill runs the current npm release of socialdatax-skills locally while SOCIALDATAX_API_KEY is available.\n\nMitigation: Use a pinned and reviewed package version where possible, and run it in a controlled environment that exposes only the required API key.\n\nRisk: The security verdict is suspicious because the runtime package can access local execution, filesystem, network, and the API key available to the agent.\n\nMitigation: Limit filesystem and network access for the agent environment, review the package before deployment, and avoid sharing unrelated credentials with the process.\n\n## Reference(s):\n\n- [SocialDataX AI homepage and API key management](https://socialdatax.com/ai?from=clawhub)\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/xhs-content-research)\n- [ClawHub publisher profile](https://clawhub.ai/user/devinchen2014)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Markdown with optional shell command snippets, links, IDs, and analysis notes]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include visible evidence, topic patterns, audience feedback, creator positioning, cited samples, and follow-up research angles.]\n\n## Skill Version(s):\n\n0.1.10 (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 v0.1.9: 3 files, 5247 bytes\n\nFiles: skill-card.md (2483b), SKILL.md (7064b), _meta.json (139b)\n\nFile v0.1.9:SKILL.md\n\n---\nname: \"xhs-content-research\"\ndescription: \"面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"xhs-content-research\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"📌\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 小红书内容研究\n\n## 适用场景\n\n面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\n\n## 快速开始\n\n- 先给出当前 skill 支持的输入：关键词或选题方向。\n- 如果你只想先看样本，先取 1 页；要继续扩大，再按参数说明使用分页或 `--max-items`。\n- 你通常会得到：相关标题、作者或账号、链接或内容 ID，以及可继续追问的角度。\n\n## API Key 获取\n\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## 直接调用命令\n\n优先使用 direct CLI；能运行 shell 命令的 Agent 不需要额外配置 MCP server：\n\n```bash\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research\n\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research\n```\n\n## 参数说明\n\n搜索：\n- 必填：`--keyword `：内容研究主题；使用用户真实意图，去掉多余空格，并保持关键词聚焦。\n- 可选：`--sort-type `：可选排序参数；不传就使用默认排序。\n- 可选：`--note-type `：可选内容类型筛选；默认是 `all`。\n- 可选：`--publish-time-range `：可选发布时间筛选；默认是 `all`。\n- 可选：`--pages `：从当前起点继续获取并合并 N 页搜索结果；如果返回了 `next_page_token`，可继续续页。\n- 可选：`--max-items `：收集到 N 条搜索结果后停止。\n- 可选：`--since-days <1-365>`：只保留最近 N 天内公开 `publish_time` 落在范围内的搜索结果；搜索范围仍受 `--pages` 限制。\n\n通用：\n- 可选：`--page-token `：这是不透明的分页 token；第一页不要传。继续同一条搜索链路时，只能原样传回完整返回的 `next_page_token`，不能截断、改写、脱敏、重建，或用省略号替换中间内容。\n- 可选：`--pretty`：只影响输出格式，不改变实际请求结果。\n- 可选：`--source-client socialdatax-skills --source-platform clawhub --source-skill xhs-content-research`：这是当前 Agent Skill 的来源标记；按本 Skill 示例执行时保持这些值不变。\n\n## 输出建议\n\n优先输出可直接复盘的结果：相关样本和主要角度，并标出下一步可继续追问的问题。\n\n先把可见证据和你的判断分开写；当用户需要可追溯结论时，重点整理话题模式、内容角度、受众反馈、创作者定位和可引用样本。\n对于 XHS 搜索结果里的 `note_url`，无论是在最终回答、展示、引用、存储、输出还是转发时，都要保留完整原始 URL，包括其中的 `xsec_token` 查询参数；不要改写、截断、脱敏、重建，也不要只根据 `note_id` 去拼链接。\n对于 XHS `note_id`，要完整复制 24 位小写十六进制 ID；不要只传或只展示前缀。\n当用户要看最近话题时，优先使用 CLI 的 `--since-days 7`，或者按用户指定的天数窗口执行；不要把当前返回页范围说成全平台完整覆盖。\n\n## MCP 工具\n\n与上面 direct CLI 命令对应的 MCP 工具：\n\n- `xhs_search_notes`\n\n在 XHS 搜索场景中，调用 `xhs_search_notes` 时传 `keyword`，可选传 `page_token`、`sort_type`、`note_type` 和 `publish_time_range`。\n\n调用 `xhs_search_notes` 时不要传 `page`；第一页也不要传 `page_token`。\n只有在 `next_page_token` 非空时才继续翻页；并且在同一个关键词、排序、内容类型、发布时间范围和调用链路下，把完整返回的 `next_page_token` 原样作为 `page_token` 传回。\n\n## 安全边界\n\n这是只读 skill。运行时使用用户环境变量中的 `SOCIALDATAX_API_KEY`；生成的 Skill 文件不包含 API Key。不会读取本地浏览器数据，也不会执行登录、发帖、点赞、评论或账号修改。\n\n## 示例结果\n\n- 示例展示格式，不代表固定字段：内容样本=标题/作者/链接或 ID；判断=相关原因和下一步。\n\n## 异常处理\n\n- 如果出现 SDK/依赖缺失、npm 网络、Node.js/npm/npx 不可用或执行权限错误：这是本地运行环境、依赖安装、网络或 AI 平台授权问题，不是 SocialDataX API Key 或业务数据返回错误；有权限时可自动安装或修复；需要网络或执行授权时提醒用户同意或完成授权；处理后继续原命令；不要改用公开网页搜索替代 SocialDataX 数据。\n- 非余额不足的网络或 API 异常：保留错误信息，检查 `SOCIALDATAX_API_KEY`、参数和链接格式后原样重试一次。\n- 如果返回 `insufficient_balance` 或“积分不足”：不要重复重试；把错误里的充值链接原样展示给用户，并提醒用户充值后继续执行刚才同一条命令。\n- 如果用户已经充值但仍提示余额不足：确认当前环境变量 `SOCIALDATAX_API_KEY` 是否来自刚充值的同一个账号；必要时重新复制官网后台的 API Key。\n- 分页中断：保留已取得的结果；重试仍失败：说明当前调用不可用，请用户补充或更换关键词、链接、ID 等输入后再重试。\n\n## 常见问题\n\n- 没结果：放宽关键词、减少限定，或换成更贴近用户表达的词。\n- 结果太多：补场景、人群、品牌、时间范围或账号名。\n- 调用失败：先确认 `SOCIALDATAX_API_KEY` 已配置；如果是 `insufficient_balance` 或“积分不足”，按错误里的充值链接充值后继续原命令，不要反复重试。\n- 担心账号安全：这是只读能力，不登录、不发帖、不点赞、不评论。\n- 想继续分析：把最相关的 1-3 条结果发回来，继续缩小范围。\n\nFile v0.1.9:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"xhs-content-research\",\n \"version\": \"0.1.9\",\n \"publishedAt\": 1786456866728\n}\n\nFile v0.1.9:skill-card.md\n\n## Description:\n\n面向内容运营、品牌调研和创作者的小红书内容研究辅助技能，用于 RedNote / XHS / Xiaohongshu 内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[devinchen2014](https://clawhub.ai/user/devinchen2014)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nContent operators, brand researchers, creators, and agents use this skill to search public XHS/RedNote content by keyword, inspect sample notes, compare topic angles, and organize follow-up research questions.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Search keywords, pagination tokens, and the SocialDataX API key are sent to SocialDataX through the npm CLI.\n\nMitigation: Install and run the skill only when that data sharing is acceptable, and keep SOCIALDATAX_API_KEY scoped and protected in the runtime environment.\n\nRisk: Returned XHS note URLs may include xsec_token query parameters that can be sensitive when shared broadly.\n\nMitigation: Share full returned URLs only with audiences that should receive the complete source link, and avoid unnecessary reposting or persistence of those URLs.\n\nRisk: Returned pages are samples from the requested query and pagination window, not complete coverage of all XHS content.\n\nMitigation: Separate observed evidence from conclusions, document query parameters, and avoid presenting sampled results as platform-wide exhaustive findings.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/xhs-content-research)\n- [SocialDataX API key and product page](https://socialdatax.com/ai?from=clawhub)\n- [Publisher profile](https://clawhub.ai/user/devinchen2014)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with CLI command examples and structured research notes]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include public XHS note URLs, note IDs, pagination tokens, and suggested follow-up analysis angles.]\n\n## Skill Version(s):\n\n0.1.9 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v0.1.8: 3 files, 5299 bytes\n\nFiles: skill-card.md (2334b), SKILL.md (7324b), _meta.json (139b)\n\nFile v0.1.8:SKILL.md\n\n---\nname: \"xhs-content-research\"\ndescription: \"面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"xhs-content-research\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"📌\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 小红书内容研究\n\n## 适用场景\n\n面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\n\n## 快速开始\n\n- 先给出当前 skill 支持的输入：关键词或选题方向。\n- 如果你只想先看样本，先取 1 页；要继续扩大，再按参数说明使用分页或 `--max-items`。\n- 你通常会得到：相关标题、作者或账号、链接或内容 ID，以及可继续追问的角度。\n\n## API Key 获取\n\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## 直接调用命令\n\n优先使用 direct CLI；能运行 shell 命令的 Agent 不需要额外配置 MCP server：\n\n```bash\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research\n\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research\n```\n\n## 参数说明\n\n搜索：\n- 必填：`--keyword `：内容研究主题；使用用户真实意图，去掉多余空格，并保持关键词聚焦。\n- 可选：`--sort-type `：可选排序参数；不传就使用默认排序。\n- 可选：`--note-type `：可选内容类型筛选；默认是 `all`。\n- 可选：`--publish-time-range `：可选发布时间筛选；默认是 `all`。\n- 可选：`--pages `：从当前起点继续获取并合并 N 页搜索结果；如果返回了 `next_page_token`，可继续续页。\n- 可选：`--max-items `：收集到 N 条搜索结果后停止。\n- 可选：`--since-days <1-365>`：只保留最近 N 天内公开 `publish_time` 落在范围内的搜索结果；搜索范围仍受 `--pages` 限制。\n\n通用：\n- 可选：`--page-token `：这是不透明的分页 token；第一页不要传。继续同一条搜索链路时，只能原样传回完整返回的 `next_page_token`，不能截断、改写、脱敏、重建，或用省略号替换中间内容。\n- 可选：`--pretty`：只影响输出格式，不改变实际请求结果。\n- 可选：`--source-client socialdatax-skills --source-platform clawhub --source-skill xhs-content-research`：这是当前 Agent Skill 的来源标记；按本 Skill 示例执行时保持这些值不变。\n\n## 输出建议\n\n优先输出可直接复盘的结果：相关样本和主要角度，并标出下一步可继续追问的问题。\n\n先把可见证据和你的判断分开写；当用户需要可追溯结论时，重点整理话题模式、内容角度、受众反馈、创作者定位和可引用样本。\n对于 XHS 搜索结果里的 `note_url`，无论是在最终回答、展示、引用、存储、输出还是转发时，都要保留完整原始 URL，包括其中的 `xsec_token` 查询参数；不要改写、截断、脱敏、重建，也不要只根据 `note_id` 去拼链接。\n对于 XHS `note_id`，要完整复制 24 位小写十六进制 ID；不要只传或只展示前缀。\n当用户要看最近话题时，优先使用 CLI 的 `--since-days 7`，或者按用户指定的天数窗口执行；不要把当前返回页范围说成全平台完整覆盖。\n\n## MCP 工具\n\n与上面 direct CLI 命令对应的 MCP 工具：\n\n- `xhs_search_notes`\n\n在 XHS 搜索场景中，调用 `xhs_search_notes` 时传 `keyword`，可选传 `page_token`、`sort_type`、`note_type` 和 `publish_time_range`。\n\n调用 `xhs_search_notes` 时不要传 `page`；第一页也不要传 `page_token`。\n只有在 `next_page_token` 非空时才继续翻页；并且在同一个关键词、排序、内容类型、发布时间范围和调用链路下，把完整返回的 `next_page_token` 原样作为 `page_token` 传回。\n\n小红书搜索参数命名提醒：direct CLI 使用 `--sort-type`、`--publish-time-range`、`--note-type`；MCP 工具 `xhs_search_notes` 使用 `sort_type`、`publish_time_range`、`note_type`。不要传 `sortType`、`publishTimeRange` 或 `noteType`。\n\n## 安全边界\n\n这是只读 skill。运行时使用用户环境变量中的 `SOCIALDATAX_API_KEY`；生成的 Skill 文件不包含 API Key。不会读取本地浏览器数据，也不会执行登录、发帖、点赞、评论或账号修改。\n\n## 示例结果\n\n- 示例展示格式，不代表固定字段：内容样本=标题/作者/链接或 ID；判断=相关原因和下一步。\n\n## 异常处理\n\n- 如果出现 SDK/依赖缺失、npm 网络、Node.js/npm/npx 不可用或执行权限错误：这是本地运行环境、依赖安装、网络或 AI 平台授权问题，不是 SocialDataX API Key 或业务数据返回错误；有权限时可自动安装或修复；需要网络或执行授权时提醒用户同意或完成授权；处理后继续原命令；不要改用公开网页搜索替代 SocialDataX 数据。\n- 非余额不足的网络或 API 异常：保留错误信息，检查 `SOCIALDATAX_API_KEY`、参数和链接格式后原样重试一次。\n- 如果返回 `insufficient_balance` 或“积分不足”：不要重复重试；把错误里的充值链接原样展示给用户，并提醒用户充值后继续执行刚才同一条命令。\n- 如果用户已经充值但仍提示余额不足：确认当前环境变量 `SOCIALDATAX_API_KEY` 是否来自刚充值的同一个账号；必要时重新复制官网后台的 API Key。\n- 分页中断：保留已取得的结果；重试仍失败：说明当前调用不可用，请用户补充或更换关键词、链接、ID 等输入后再重试。\n\n## 常见问题\n\n- 没结果：放宽关键词、减少限定，或换成更贴近用户表达的词。\n- 结果太多：补场景、人群、品牌、时间范围或账号名。\n- 调用失败：先确认 `SOCIALDATAX_API_KEY` 已配置；如果是 `insufficient_balance` 或“积分不足”，按错误里的充值链接充值后继续原命令，不要反复重试。\n- 担心账号安全：这是只读能力，不登录、不发帖、不点赞、不评论。\n- 想继续分析：把最相关的 1-3 条结果发回来，继续缩小范围。\n\nFile v0.1.8:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"xhs-content-research\",\n \"version\": \"0.1.8\",\n \"publishedAt\": 1786415906479\n}\n\nFile v0.1.8:skill-card.md\n\n## Description:\n\n面向内容运营、品牌调研和创作者的小红书内容研究辅助技能，适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[devinchen2014](https://clawhub.ai/user/devinchen2014)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nContent operators, brand researchers, and creators use this skill to perform read-only XHS content research from keywords or topic directions. It helps agents collect visible samples, compare content angles, review trends, and organize follow-up questions for topic or competitor analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Generated reports can include full XHS note URLs with xsec_token parameters.\n\nMitigation: Avoid forwarding reports or logs broadly; share sanitized links when traceability is not needed.\n\nRisk: The skill depends on the SocialDataX npm package and an API key in the user's environment.\n\nMitigation: Install only when comfortable with that package and protect SOCIALDATAX_API_KEY from logs, commits, and shared outputs.\n\nRisk: Search results are sampled from requested pages and filters, not guaranteed complete platform coverage.\n\nMitigation: State the query, filters, and page limits with conclusions, and broaden or repeat searches before treating findings as comprehensive.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/xhs-content-research)\n- [SocialDataX AI access](https://socialdatax.com/ai?from=clawhub)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown with inline shell commands and structured result summaries]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY and Node.js/npm; generated reports may include full XHS note URLs.]\n\n## Skill Version(s):\n\n0.1.8 (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 v0.1.7: 3 files, 4496 bytes\n\nFiles: skill-card.md (2455b), SKILL.md (5676b), _meta.json (139b)\n\nFile v0.1.7:SKILL.md\n\n---\nname: \"xhs-content-research\"\ndescription: \"用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理。覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"xhs-content-research\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔎\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 小红书内容研究\n\nUse this skill when the user wants 小红书内容研究, 小红书内容分析, 小红书笔记分析, Xiaohongshu / XHS / RedNote content research, note sample research, content angle discovery, topic inspiration, competitor content observation, or trend material collection.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --sort-type like_count_descending --pages 2 --max-items 20 \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill xhs-content-research\n```\n\nRequired arguments:\n\n- `--keyword `: required; use the user's product, category, topic, scenario, or competitor keyword. Keep the keyword focused and avoid broad filler words.\n\nOptional arguments:\n\n- `--sort-type `: optional; for sample research, prefer `like_count_descending` unless the user asks for newest content.\n- `--note-type `: optional note type filter; default is `all`.\n- `--publish-time-range `: optional publish-time range; default is `all`.\n- `--page-token `: opaque pagination token; pass the complete returned token back unchanged for the same keyword and filter chain.\n- `--pages `: fetch and merge N pages from the current starting point.\n- `--max-items `: stop after collecting N results.\n- `--since-days <1-365>`: keep only returned items whose public `publish_time` is within the last N days; still limited by the requested pages.\n- `--pretty`: output formatting only.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill xhs-content-research`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `xhs_search_notes`\n\nFor XHS, call `xhs_search_notes` with `keyword`, optional `page_token`, `sort_type`, `note_type`, and `publish_time_range`.\n\nDo not pass `page` to `xhs_search_notes`; omit `page_token` on the first request.\nContinue pagination only when `next_page_token` is not empty, and pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword, sort, note type, publish-time range, and caller chain.\n\nXHS search parameter naming reminder: direct CLI uses `--sort-type`, `--publish-time-range`, and `--note-type`; the `xhs_search_notes` MCP tool uses `sort_type`, `publish_time_range`, and `note_type`. Do not pass `sortType`, `publishTimeRange`, or `noteType`.\n\n## Output Guidance\n\n输出为小红书内容研究报告：样本表、标题钩子、内容角度、互动信号、可复用选题、完整原始 URL 和完整 `note_id`。\n只基于当前搜索关键词和当前返回页范围内的公开结果做判断；不承诺全平台完整覆盖、账号诊断、发布操作、封面制作或确定性流量结果。\nFor XHS search results, in every use of a returned `note_url`, such as final answers, display, references, storage, output, or forwarding, preserve it exactly as the full URL, including `xsec_token` query parameters. Do not modify, truncate, redact, mask, normalize, rebuild, or synthesize the URL from `note_id`.\nFor XHS `note_id`, copy the complete 24-character lowercase hexadecimal ID exactly; do not pass or display only a prefix.\n\n## Troubleshooting\n\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.7:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"xhs-content-research\",\n \"version\": \"0.1.7\",\n \"publishedAt\": 1785900268293\n}\n\nFile v0.1.7:skill-card.md\n\n## Description:\n\nResearches public Xiaohongshu/XHS/RedNote notes through SocialDataX for content angles, keyword research, trend material, competitor observation, and sample reports.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[devinchen2014](https://clawhub.ai/user/devinchen2014)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to run read-only XHS note searches with a SocialDataX API key and turn returned public note data into content research reports, including sample tables, title hooks, content angles, engagement signals, reusable topics, full note URLs, and complete note IDs.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill depends on an external SocialDataX service, npm package, and SOCIALDATAX_API_KEY for data calls.\n\nMitigation: Before installation or use, confirm trust in the SocialDataX service and package, and manage the API key through the documented SocialDataX homepage.\n\nRisk: Research keywords and API credentials are used for external data calls.\n\nMitigation: Use an appropriate API key for the intended account and avoid submitting sensitive research terms unless that external processing is acceptable.\n\nRisk: Outputs may be incomplete or misleading if treated as full-platform coverage or deterministic traffic guidance.\n\nMitigation: Interpret results only within the current keyword, filters, and returned page range, and review conclusions before using them for decisions.\n\n## Reference(s):\n\n- [SocialDataX API access and homepage](https://socialdatax.com/ai?from=clawhub)\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/xhs-content-research)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown content research report with optional shell command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Reports should preserve returned note URLs exactly, including xsec_token query parameters, and copy complete 24-character lowercase hexadecimal note IDs.]\n\n## Skill Version(s):\n\n0.1.7 (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 v0.1.6: 3 files, 4682 bytes\n\nFiles: skill-card.md (2727b), SKILL.md (5709b), _meta.json (139b)\n\nFile v0.1.6:SKILL.md\n\n---\nname: \"xhs-content-research\"\ndescription: \"用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理。覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"xhs-content-research\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔎\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 小红书内容研究\n\nUse this skill when the user wants 小红书内容研究, 小红书内容分析, 小红书笔记分析, Xiaohongshu / XHS / RedNote content research, note sample research, content angle discovery, topic inspiration, competitor content observation, or trend material collection.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名；do not infer alternate domains。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --sort-type like_count_descending --pages 2 --max-items 20 \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill xhs-content-research\n```\n\nRequired arguments:\n\n- `--keyword `: required; use the user's product, category, topic, scenario, or competitor keyword. Keep the keyword focused and avoid broad filler words.\n\nOptional arguments:\n\n- `--sort-type `: optional; for sample research, prefer `like_count_descending` unless the user asks for newest content.\n- `--note-type `: optional note type filter; default is `all`.\n- `--publish-time-range `: optional publish-time range; default is `all`.\n- `--page-token `: opaque pagination token; pass the complete returned token back unchanged for the same keyword and filter chain.\n- `--pages `: fetch and merge N pages from the current starting point.\n- `--max-items `: stop after collecting N results.\n- `--since-days <1-365>`: keep only returned items whose public `publish_time` is within the last N days; still limited by the requested pages.\n- `--pretty`: output formatting only.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill xhs-content-research`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `xhs_search_notes`\n\nFor XHS, call `xhs_search_notes` with `keyword`, optional `page_token`, `sort_type`, `note_type`, and `publish_time_range`.\n\nDo not pass `page` to `xhs_search_notes`; omit `page_token` on the first request.\nContinue pagination only when `next_page_token` is not empty, and pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword, sort, note type, publish-time range, and caller chain.\n\nXHS search parameter naming reminder: direct CLI uses `--sort-type`, `--publish-time-range`, and `--note-type`; the `xhs_search_notes` MCP tool uses `sort_type`, `publish_time_range`, and `note_type`. Do not pass `sortType`, `publishTimeRange`, or `noteType`.\n\n## Output Guidance\n\n输出为小红书内容研究报告：样本表、标题钩子、内容角度、互动信号、可复用选题、完整原始 URL 和完整 `note_id`。\n只基于当前搜索关键词和当前返回页范围内的公开结果做判断；不承诺全平台完整覆盖、账号诊断、发布操作、封面制作或确定性流量结果。\nFor XHS search results, in every use of a returned `note_url`, such as final answers, display, references, storage, output, or forwarding, preserve it exactly as the full URL, including `xsec_token` query parameters. Do not modify, truncate, redact, mask, normalize, rebuild, or synthesize the URL from `note_id`.\nFor XHS `note_id`, copy the complete 24-character lowercase hexadecimal ID exactly; do not pass or display only a prefix.\n\n## Troubleshooting\n\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.6:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"xhs-content-research\",\n \"version\": \"0.1.6\",\n \"publishedAt\": 1785322248962\n}\n\nFile v0.1.6:skill-card.md\n\n## Description:
\n用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理。覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users, marketers, and content researchers use this skill to research public Xiaohongshu/XHS/RedNote notes for content angles, keyword research, competitor observation, trend material, and topic inspiration.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Search terms are sent to SocialDataX with the user's SOCIALDATAX_API_KEY.
\nMitigation: Use only queries appropriate to share with SocialDataX and configure the API key in the runtime environment rather than embedding it in files.
\nRisk: Returned note URLs may include full query parameters such as xsec_token.
\nMitigation: Preserve returned note URLs exactly when needed for traceability, and avoid sharing outputs with audiences that should not receive those full URLs.
\nRisk: Research findings may overstate coverage because results are limited to the searched keyword and returned pages.
\nMitigation: State that analysis is based only on the current query and returned public result set, and avoid claiming complete platform coverage or deterministic traffic outcomes.
\n\n\n## Reference(s):
\n- [SocialDataX API access](https://socialdatax.com/ai?from=clawhub)
\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/xhs-content-research)
\n- [ClawHub publisher profile](https://clawhub.ai/user/devinchen2014)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Shell commands, API Calls, Guidance]
\n**Output Format:** [Markdown research report with sample tables, content angles, interaction signals, reusable topic ideas, full note URLs, note IDs, and inline shell commands when needed]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Preserves returned note_url values exactly, including xsec_token query parameters; conclusions are limited to the current keyword and returned public result pages.]
\n\n## Skill Version(s):
\n0.1.6 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v0.1.5: 3 files, 4593 bytes\n\nFiles: skill-card.md (2455b), SKILL.md (5709b), _meta.json (139b)\n\nFile v0.1.5:SKILL.md\n\n---\nname: \"xhs-content-research\"\ndescription: \"用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理。覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"xhs-content-research\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔎\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 小红书内容研究\n\nUse this skill when the user wants 小红书内容研究, 小红书内容分析, 小红书笔记分析, Xiaohongshu / XHS / RedNote content research, note sample research, content angle discovery, topic inspiration, competitor content observation, or trend material collection.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名；do not infer alternate domains。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --sort-type like_count_descending --pages 2 --max-items 20 \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill xhs-content-research\n```\n\nRequired arguments:\n\n- `--keyword `: required; use the user's product, category, topic, scenario, or competitor keyword. Keep the keyword focused and avoid broad filler words.\n\nOptional arguments:\n\n- `--sort-type `: optional; for sample research, prefer `like_count_descending` unless the user asks for newest content.\n- `--note-type `: optional note type filter; default is `all`.\n- `--publish-time-range `: optional publish-time range; default is `all`.\n- `--page-token `: opaque pagination token; pass the complete returned token back unchanged for the same keyword and filter chain.\n- `--pages `: fetch and merge N pages from the current starting point.\n- `--max-items `: stop after collecting N results.\n- `--since-days <1-365>`: keep only returned items whose public `publish_time` is within the last N days; still limited by the requested pages.\n- `--pretty`: output formatting only.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill xhs-content-research`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `xhs_search_notes`\n\nFor XHS, call `xhs_search_notes` with `keyword`, optional `page_token`, `sort_type`, `note_type`, and `publish_time_range`.\n\nDo not pass `page` to `xhs_search_notes`; omit `page_token` on the first request.\nContinue pagination only when `next_page_token` is not empty, and pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword, sort, note type, publish-time range, and caller chain.\n\nXHS search parameter naming reminder: direct CLI uses `--sort-type`, `--publish-time-range`, and `--note-type`; the `xhs_search_notes` MCP tool uses `sort_type`, `publish_time_range`, and `note_type`. Do not pass `sortType`, `publishTimeRange`, or `noteType`.\n\n## Output Guidance\n\n输出为小红书内容研究报告：样本表、标题钩子、内容角度、互动信号、可复用选题、完整原始 URL 和完整 `note_id`。\n只基于当前搜索关键词和当前返回页范围内的公开结果做判断；不承诺全平台完整覆盖、账号诊断、发布操作、封面制作或确定性流量结果。\nFor XHS search results, in every use of a returned `note_url`, such as final answers, display, references, storage, output, or forwarding, preserve it exactly as the full URL, including `xsec_token` query parameters. Do not modify, truncate, redact, mask, normalize, rebuild, or synthesize the URL from `note_id`.\nFor XHS `note_id`, copy the complete 24-character lowercase hexadecimal ID exactly; do not pass or display only a prefix.\n\n## Troubleshooting\n\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.5:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"xhs-content-research\",\n \"version\": \"0.1.5\",\n \"publishedAt\": 1785319176958\n}\n\nFile v0.1.5:skill-card.md\n\n## Description:
\n用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理。覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and content researchers use this skill to search public Xiaohongshu/XHS/RedNote notes through SocialDataX, then turn returned samples into content angles, topic ideas, competitor observations, trend material, and research reports.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill sends API-key-authenticated search requests to SocialDataX.
\nMitigation: Use only a trusted SOCIALDATAX_API_KEY, keep it private, and install only when SocialDataX is acceptable for the research workflow.
\nRisk: Returned Xiaohongshu note URLs may include full query parameters that should be reviewed before redistribution.
\nMitigation: Review full returned URLs before sharing outputs while preserving exact URLs when they are needed as research references.
\nRisk: Custom upstream endpoint environment variables could redirect requests to an unintended service.
\nMitigation: Avoid custom upstream endpoint settings unless the endpoint is intentionally configured and trusted.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/xhs-content-research)
\n- [SocialDataX API access](https://socialdatax.com/ai?from=clawhub)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Shell commands, API calls, Guidance]
\n**Output Format:** [Markdown research report with sample tables, links, note IDs, and optional shell commands]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Preserves returned full note URLs, including query parameters, and complete 24-character note IDs.]
\n\n## Skill Version(s):
\n0.1.5 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v0.1.4: 3 files, 4424 bytes\n\nFiles: skill-card.md (2205b), SKILL.md (5448b), _meta.json (139b)\n\nFile v0.1.4:SKILL.md\n\n---\nname: \"xhs-content-research\"\ndescription: \"用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理。覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"xhs-content-research\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔎\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 小红书内容研究\n\nUse this skill when the user wants 小红书内容研究, 小红书内容分析, 小红书笔记分析, Xiaohongshu / XHS / RedNote content research, note sample research, content angle discovery, topic inspiration, competitor content observation, or trend material collection.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名；do not infer alternate domains。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --sort-type like_count_descending --pages 2 --max-items 20 \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill xhs-content-research\n```\n\nRequired arguments:\n\n- `--keyword `: required; use the user's product, category, topic, scenario, or competitor keyword. Keep the keyword focused and avoid broad filler words.\n\nOptional arguments:\n\n- `--sort-type `: optional; for sample research, prefer `like_count_descending` unless the user asks for newest content.\n- `--note-type `: optional note type filter; default is `all`.\n- `--publish-time-range `: optional publish-time range; default is `all`.\n- `--page-token `: opaque pagination token; pass the complete returned token back unchanged for the same keyword and filter chain.\n- `--pages `: fetch and merge N pages from the current starting point.\n- `--max-items `: stop after collecting N results.\n- `--since-days <1-365>`: keep only returned items whose public `publish_time` is within the last N days; still limited by the requested pages.\n- `--pretty`: output formatting only.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill xhs-content-research`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `xhs_search_notes`\n\nFor XHS, call `xhs_search_notes` with `keyword`, optional `page_token`, `sort_type`, `note_type`, and `publish_time_range`.\n\nDo not pass `page` to `xhs_search_notes`; omit `page_token` on the first request.\nContinue pagination only when `next_page_token` is not empty, and pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword, sort, note type, publish-time range, and caller chain.\n\n## Output Guidance\n\n输出为小红书内容研究报告：样本表、标题钩子、内容角度、互动信号、可复用选题、完整原始 URL 和完整 `note_id`。\n只基于当前搜索关键词和当前返回页范围内的公开结果做判断；不承诺全平台完整覆盖、账号诊断、发布操作、封面制作或确定性流量结果。\nFor XHS search results, in every use of a returned `note_url`, such as final answers, display, references, storage, output, or forwarding, preserve it exactly as the full URL, including `xsec_token` query parameters. Do not modify, truncate, redact, mask, normalize, rebuild, or synthesize the URL from `note_id`.\nFor XHS `note_id`, copy the complete 24-character lowercase hexadecimal ID exactly; do not pass or display only a prefix.\n\n## Troubleshooting\n\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.4:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"xhs-content-research\",\n \"version\": \"0.1.4\",\n \"publishedAt\": 1784546957713\n}\n\nFile v0.1.4:skill-card.md\n\n## Description:
\n用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理。覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users, marketers, researchers, and content strategists use this skill to research public Xiaohongshu / XHS / RedNote notes for keyword research, topic ideas, competitor content observation, trend material, sample tables, content angles, and engagement signals.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill depends on the SocialDataX npm package and API service.
\nMitigation: Install and use it only after confirming you trust the package, the API service, and the account tied to SOCIALDATAX_API_KEY.
\nRisk: Outputs may include full Xiaohongshu note URLs with xsec_token query parameters.
\nMitigation: Review destinations before displaying, storing, or forwarding returned URLs, especially outside the user's intended workflow.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/xhs-content-research)
\n- [SocialDataX API access](https://socialdatax.com/ai?from=clawhub)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, guidance]
\n**Output Format:** [Markdown research report with sample tables, concise analysis, URLs, note IDs, and optional shell command guidance]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY plus node and npm when using the direct CLI.]
\n\n## Skill Version(s):
\n0.1.4 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v0.1.3: 3 files, 4518 bytes\n\nFiles: skill-card.md (2489b), SKILL.md (5448b), _meta.json (139b)\n\nFile v0.1.3:SKILL.md\n\n---\nname: \"xhs-content-research\"\ndescription: \"用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理。覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"xhs-content-research\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔎\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 小红书内容研究\n\nUse this skill when the user wants 小红书内容研究, 小红书内容分析, 小红书笔记分析, Xiaohongshu / XHS / RedNote content research, note sample research, content angle discovery, topic inspiration, competitor content observation, or trend material collection.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名；do not infer alternate domains。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --sort-type like_count_descending --pages 2 --max-items 20 \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill xhs-content-research\n```\n\nRequired arguments:\n\n- `--keyword `: required; use the user's product, category, topic, scenario, or competitor keyword. Keep the keyword focused and avoid broad filler words.\n\nOptional arguments:\n\n- `--sort-type `: optional; for sample research, prefer `like_count_descending` unless the user asks for newest content.\n- `--note-type `: optional note type filter; default is `all`.\n- `--publish-time-range `: optional publish-time range; default is `all`.\n- `--page-token `: opaque pagination token; pass the complete returned token back unchanged for the same keyword and filter chain.\n- `--pages `: fetch and merge N pages from the current starting point.\n- `--max-items `: stop after collecting N results.\n- `--since-days <1-365>`: keep only returned items whose public `publish_time` is within the last N days; still limited by the requested pages.\n- `--pretty`: output formatting only.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill xhs-content-research`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `xhs_search_notes`\n\nFor XHS, call `xhs_search_notes` with `keyword`, optional `page_token`, `sort_type`, `note_type`, and `publish_time_range`.\n\nDo not pass `page` to `xhs_search_notes`; omit `page_token` on the first request.\nContinue pagination only when `next_page_token` is not empty, and pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword, sort, note type, publish-time range, and caller chain.\n\n## Output Guidance\n\n输出为小红书内容研究报告：样本表、标题钩子、内容角度、互动信号、可复用选题、完整原始 URL 和完整 `note_id`。\n只基于当前搜索关键词和当前返回页范围内的公开结果做判断；不承诺全平台完整覆盖、账号诊断、发布操作、封面制作或确定性流量结果。\nFor XHS search results, in every use of a returned `note_url`, such as final answers, display, references, storage, output, or forwarding, preserve it exactly as the full URL, including `xsec_token` query parameters. Do not modify, truncate, redact, mask, normalize, rebuild, or synthesize the URL from `note_id`.\nFor XHS `note_id`, copy the complete 24-character lowercase hexadecimal ID exactly; do not pass or display only a prefix.\n\n## Troubleshooting\n\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.3:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"xhs-content-research\",\n \"version\": \"0.1.3\",\n \"publishedAt\": 1784543800030\n}\n\nFile v0.1.3:skill-card.md\n\n## Description:
\n用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理。覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and content researchers use this skill to collect public Xiaohongshu, XHS, or RedNote note samples and turn them into content angles, keyword research, topic ideas, competitor observations, and trend material.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill uses a SocialDataX API key and npm CLI to fetch public Xiaohongshu note results.
\nMitigation: Confirm trust in the SocialDataX npm package and API service before installing or running the skill.
\nRisk: Search results may include full returned XHS URLs, including query parameters.
\nMitigation: Review outputs before sharing or storing them, and preserve returned URLs only where the workflow requires exact references.
\nRisk: Research conclusions are limited to the current keyword, filters, and returned pages.
\nMitigation: Avoid treating outputs as complete platform coverage or deterministic performance predictions.
\n\n\n## Reference(s):
\n- [SocialDataX AI access page](https://socialdatax.com/ai?from=clawhub)
\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/xhs-content-research)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]
\n**Output Format:** [Markdown reports with sample tables, content angles, interaction signals, reusable topics, note URLs, note IDs, and optional CLI command examples]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Read-only research output based on the requested keyword, filters, and returned public result pages; preserves full returned note URLs and 24-character note IDs.]
\n\n## Skill Version(s):
\n0.1.3 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v0.1.2: 3 files, 4366 bytes\n\nFiles: skill-card.md (2478b), SKILL.md (5442b), _meta.json (139b)\n\nFile v0.1.2:SKILL.md\n\n---\nname: \"xhs-content-research\"\ndescription: \"用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理。覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"xhs-content-research\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔎\",\"homepage\":\"https://socialdatax.com/?from=clawhub\"}}\n---\n\n\n# 小红书内容研究\n\nUse this skill when the user wants 小红书内容研究, 小红书内容分析, 小红书笔记分析, Xiaohongshu / XHS / RedNote content research, note sample research, content angle discovery, topic inspiration, competitor content observation, or trend material collection.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名；do not infer alternate domains。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --sort-type like_count_descending --pages 2 --max-items 20 \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill xhs-content-research\n```\n\nRequired arguments:\n\n- `--keyword `: required; use the user's product, category, topic, scenario, or competitor keyword. Keep the keyword focused and avoid broad filler words.\n\nOptional arguments:\n\n- `--sort-type `: optional; for sample research, prefer `like_count_descending` unless the user asks for newest content.\n- `--note-type `: optional note type filter; default is `all`.\n- `--publish-time-range `: optional publish-time range; default is `all`.\n- `--page-token `: opaque pagination token; pass the complete returned token back unchanged for the same keyword and filter chain.\n- `--pages `: fetch and merge N pages from the current starting point.\n- `--max-items `: stop after collecting N results.\n- `--since-days <1-365>`: keep only returned items whose public `publish_time` is within the last N days; still limited by the requested pages.\n- `--pretty`: output formatting only.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill xhs-content-research`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `xhs_search_notes`\n\nFor XHS, call `xhs_search_notes` with `keyword`, optional `page_token`, `sort_type`, `note_type`, and `publish_time_range`.\n\nDo not pass `page` to `xhs_search_notes`; omit `page_token` on the first request.\nContinue pagination only when `next_page_token` is not empty, and pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword, sort, note type, publish-time range, and caller chain.\n\n## Output Guidance\n\n输出为小红书内容研究报告：样本表、标题钩子、内容角度、互动信号、可复用选题、完整原始 URL 和完整 `note_id`。\n只基于当前搜索关键词和当前返回页范围内的公开结果做判断；不承诺全平台完整覆盖、账号诊断、发布操作、封面制作或确定性流量结果。\nFor XHS search results, in every use of a returned `note_url`, such as final answers, display, references, storage, output, or forwarding, preserve it exactly as the full URL, including `xsec_token` query parameters. Do not modify, truncate, redact, mask, normalize, rebuild, or synthesize the URL from `note_id`.\nFor XHS `note_id`, copy the complete 24-character lowercase hexadecimal ID exactly; do not pass or display only a prefix.\n\n## Troubleshooting\n\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.2:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"xhs-content-research\",\n \"version\": \"0.1.2\",\n \"publishedAt\": 1784535248982\n}\n\nFile v0.1.2:skill-card.md\n\n## Description:
\nHelps agents research public Xiaohongshu/XHS/RedNote notes, popular samples, content angles, keywords, topic ideas, competitor content, and trend material using SocialDataX.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal marketers, content researchers, and agents use this skill to collect and summarize public XHS note samples, hooks, content angles, interaction signals, reusable topics, and competitor or trend material for a focused keyword.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires a SOCIALDATAX_API_KEY and uses an external SocialDataX npm CLI for data calls.
\nMitigation: Install it only when SocialDataX use is intended, provide the key through the environment, and avoid embedding keys in skill files or outputs.
\nRisk: Ambiguous social content research requests could target a platform other than XHS/RedNote.
\nMitigation: Confirm that XHS/RedNote is the intended platform before using the skill for ambiguous requests.
\nRisk: Search findings may be limited to the current keyword, filters, pages, and returned public results.
\nMitigation: Present conclusions as scoped to the returned result set and preserve full note URLs and note IDs for traceability.
\n\n\n## Reference(s):
\n- [SocialDataX homepage](https://socialdatax.com/?from=clawhub)
\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/xhs-content-research)
\n- [ClawHub publisher profile](https://clawhub.ai/user/devinchen2014)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, guidance]
\n**Output Format:** [Markdown research report with sample tables, note URLs, note IDs, and CLI command guidance]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Preserves full returned note_url values, including xsec_token query parameters, and complete 24-character note_id values.]
\n\n## Skill Version(s):
\n0.1.2 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v0.1.1: 3 files, 4151 bytes\n\nFiles: skill-card.md (2224b), SKILL.md (4782b), _meta.json (139b)\n\nFile v0.1.1:SKILL.md\n\n---\nname: \"xhs-content-research\"\ndescription: \"用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理。覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"xhs-content-research\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔎\",\"homepage\":\"https://socialdatax.com/?from=clawhub\"}}\n---\n\n\n# 小红书内容研究\n\nUse this skill when the user wants 小红书内容研究, 小红书内容分析, 小红书笔记分析, Xiaohongshu / XHS / RedNote content research, note sample research, content angle discovery, topic inspiration, competitor content observation, or trend material collection.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --sort-type like_count_descending --pages 2 --max-items 20 \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill xhs-content-research\n```\n\nRequired arguments:\n\n- `--keyword `: required; use the user's product, category, topic, scenario, or competitor keyword. Keep the keyword focused and avoid broad filler words.\n\nOptional arguments:\n\n- `--sort-type `: optional; for sample research, prefer `like_count_descending` unless the user asks for newest content.\n- `--note-type `: optional note type filter; default is `all`.\n- `--publish-time-range `: optional publish-time range; default is `all`.\n- `--page-token `: opaque pagination token; pass the complete returned token back unchanged for the same keyword and filter chain.\n- `--pages `: fetch and merge N pages from the current starting point.\n- `--max-items `: stop after collecting N results.\n- `--since-days <1-365>`: keep only returned items whose public `publish_time` is within the last N days; still limited by the requested pages.\n- `--pretty`: output formatting only.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill xhs-content-research`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `xhs_search_notes`\n\nFor XHS, call `xhs_search_notes` with `keyword`, optional `page_token`, `sort_type`, `note_type`, and `publish_time_range`.\n\nDo not pass `page` to `xhs_search_notes`; omit `page_token` on the first request.\nContinue pagination only when `next_page_token` is not empty, and pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword, sort, note type, publish-time range, and caller chain.\n\n## Output Guidance\n\n输出为小红书内容研究报告：样本表、标题钩子、内容角度、互动信号、可复用选题、完整原始 URL 和完整 `note_id`。\n只基于当前搜索关键词和当前返回页范围内的公开结果做判断；不承诺全平台完整覆盖、账号诊断、发布操作、封面制作或确定性流量结果。\nFor XHS search results, in every use of a returned `note_url`, such as final answers, display, references, storage, output, or forwarding, preserve it exactly as the full URL, including `xsec_token` query parameters. Do not modify, truncate, redact, mask, normalize, rebuild, or synthesize the URL from `note_id`.\nFor XHS `note_id`, copy the complete 24-character lowercase hexadecimal ID exactly; do not pass or display only a prefix.\n\nFile v0.1.1:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"xhs-content-research\",\n \"version\": \"0.1.1\",\n \"publishedAt\": 1784268789122\n}\n\nFile v0.1.1:skill-card.md\n\n## Description:
\n用于小红书内容研究、热门笔记样本、内容角度、关键词调研、选题参考、竞品内容观察和趋势素材整理，覆盖 Xiaohongshu / XHS / RedNote note research，来自 SocialDataX 社媒数据助手。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and content researchers use this skill to search public Xiaohongshu, XHS, or RedNote notes for sample research, content angles, keyword research, topic inspiration, competitor observation, and trend material collection through SocialDataX.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill uses SOCIALDATAX_API_KEY for CLI or API calls.
\nMitigation: Install and run it only in a trusted environment where providing the SocialDataX API key to the workflow is intended.
\nRisk: Returned Xiaohongshu note URLs may include full xsec_token query parameters.
\nMitigation: Review full note URLs before sharing or forwarding outputs, and share them only where preserving those parameters is acceptable.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/xhs-content-research)
\n- [SocialDataX API access](https://socialdatax.com/?from=clawhub)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, guidance]
\n**Output Format:** [Markdown reports with sample tables, note URLs, note IDs, and optional shell commands or API tool calls]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY plus node and npm when using the direct CLI; preserves complete returned note URLs and 24-character note IDs.]
\n\n## Skill Version(s):
\n0.1.1 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
","readmeExcerpt":"Skill: 小红书内容研究 Owner: devinchen2014 Summary: 面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。 Tags: latest:0.1.10 Version history: v0.1.10 | 2026-08-14T11:01:32.277Z | user Clarify XHS search parameter naming for MCP tool calls. v0.1.9 | 2026-08-11T14:01:06.728Z | user Refresh ClawHub mirror to match current SkillHub workflow. v0.1.8 | 2026-08-11T02:38:26.479Z | user M","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research\n\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research\n\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research\n\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --sort-type like_count_descending --pages 2 --max-items 20 \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill xhs-content-research"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --sort-type like_count_descending --pages 2 --max-items 20 \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill xhs-content-research"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --sort-type like_count_descending --pages 2 --max-items 20 \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill xhs-content-research"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"xhs-content-research\"\ndescription: \"面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"xhs-content-research\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"📌\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 小红书内容研究\n\n## 适用场景\n\n面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\n\n## 快速开始\n\n- 先给出当前 skill 支持的输入：关键词或选题方向。\n- 如果你只想先看样本，先取 1 页；要继续扩大，再按参数说明使用分页或 `--max-items`。\n- 你通常会得到：相关标题、作者或账号、链接或内容 ID，以及可继续追问的角度。\n\n## API Key 获取\n\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## 直接调用命令\n\n优先使用 direct CLI；能运行 shell 命令的 Agent 不需要额外配置 MCP server：\n\n```bash\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research\n\nnpx -y socialdatax-skills@latest xhs search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill xhs-content-research\n```\n\n## 参数说明\n\n搜索：\n- 必填：`--keyword `：内容研究主题；使用用户真实意图，去掉多余空格，并保持关键词聚焦。\n- 可选：`--sort-type `：可选排序参数；不传就使用默认排序。\n- 可选：`--note-type `：可选内容类型筛选；默认是 `all`。\n- 可选：`--publish-time-range `：可选发布时间筛选；默认是 `all`。\n- 可选：`--pages `：从当前起点继续获取并合并 N 页搜索结果；如果返回了 `next_page_token`，可继续续页。\n- 可选：`--max-items `：收集到 N 条搜索结果后停止。\n- 可选：`--since-days <1-365>`：只保留最近 N 天内公开 `publish_time` 落在范围内的搜索结果；搜索范围仍受 `--pages` 限制。\n\n通用：\n- 可选：`--page-token `：这是不透明的分页 token；第一页不要传。继续同一条搜索链路时，只能原样传回完整返回的 `next_page_token`，不能截断、改写、脱敏、重建，或用省略号替换中间内容。\n- 可选：`--pretty`：只影响输出格式，不改变实际请求结果。\n- 可选：`--source-client socialdatax-skills --source-platform clawhub --source-skill xhs-content-research`：这是当前 Agent Skill 的来源标记；按本 Skill 示例执行时保持这些值不变。\n\n## 输出建议\n\n优先输出可直接复盘的结果：相关样本和主要角度，并标出下一步可继续追问的问题。\n\n先把可见证据和你的判断分开写；当用户需要可追溯结论时，重点整理话题模式、内容角度、受众反馈、创作者定位和可引用样本。\n对于 XHS 搜索结果里的 `note_url`，无论是在最终回答、展示、引用、存储、输出还是转发时，都要保留完整原始 URL，包括其中的 `xsec_token` 查询参数；不要改写、截断、脱敏、重建，也不要只根据 `note_id` 去拼链接。\n对于 XHS `note_id`，要原样复制返回的完整 `note_id`；不要只传或只展示前缀。\n当用户要看最近话题时，优先使用 CLI 的 `--since-days 7`，或者按用户指定的天数窗口执行；不要把当前返回页范围说成全平台完整覆盖。\n\n## MCP 工具\n\n与上面 direct CLI 命令对应的 MCP 工具：\n\n- `xhs_search_notes`\n\n在 XHS 搜索场景中，调用 `xhs_search_notes` 时传 `keyword`，可选传 `page_token`、`sort_type`、`note_type` 和 `publish_time_range`。\n\n调用 `xhs_search_notes` 时不要传 `page`；第一页也不要传 `page_token`。\n只有在 `next_page_token` 非空时才继续翻页；并且在同一个关键词、排序、内容类型、发布时间范围和调用链路下，把完整返回的 "},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"xhs-content-research\",\n \"version\": \"0.1.10\",\n \"publishedAt\": 1786705292277\n}"},{"path":"skill-card.md","content":"## Description:\n\n面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[devinchen2014](https://clawhub.ai/user/devinchen2014)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nContent operators, brand researchers, and creators use this skill to search Xiaohongshu/RedNote content by keyword, compare competing content, observe trends, and organize research samples for follow-up analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill runs the current npm release of socialdatax-skills locally while SOCIALDATAX_API_KEY is available.\n\nMitigation: Use a pinned and reviewed package version where possible, and run it in a controlled environment that exposes only the required API key.\n\nRisk: The security verdict is suspicious because the runtime package can access local execution, filesystem, network, and the API key available to the agent.\n\nMitigation: Limit filesystem and network access for the agent environment, review the package before deployment, and avoid sharing unrelated credentials with the process.\n\n## Reference(s):\n\n- [SocialDataX AI homepage and API key management](https://socialdatax.com/ai?from=clawhub)\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/xhs-content-research)\n- [ClawHub publisher profile](https://clawhub.ai/user/devinchen2014)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Markdown with optional shell command snippets, links, IDs, and analysis notes]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include visible evidence, topic patterns, audience feedback, creator positioning, cited samples, and follow-up research angles.]\n\n## Skill Version(s):\n\n0.1.10 (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."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。 Skill: 小红书内容研究 Owner: devinchen2014 Summary: 面向内容运营、品牌调研和创作者的小红书内容研究辅助技能。适用于 RedNote / XHS / Xiaohongshu（小红书）内容研究、选题分析、关键词观察、趋势判断、竞品内容对比和素材整理。 Tags: latest:0.1.10 Version history: v0.1.10 | 2026-08-14T11:01:32.277Z | user Clarify XHS search parameter naming for MCP tool calls. v0.1.9 | 2026-08-11T14:01:06.728Z | user Refresh ClawHub mirror to match current SkillHub workflow. v0.1.8 | 2026-08-11T02:38:26.479Z | user M","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":877,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T18:27:57.141Z","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-10T18:27:57.141Z","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-10T21:43:21.723Z","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"}]}}}