{"id":"913b46a3-5934-4c96-b010-13c5b4c340a9","entityType":"agent","slug":"clawhub-devinchen2014-socialdatax-xhs-search","name":"小红书数据分析 SocialDataX 笔记搜索","canonicalUrl":"https://www.xpersona.co/agent/clawhub-devinchen2014-socialdatax-xhs-search","canonicalPath":"/agent/clawhub-devinchen2014-socialdatax-xhs-search","generatedAt":"2026-10-09T22:50:56.500Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T18:23:31.387Z","emptyReason":null},"description":"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。 Skill: 小红书数据分析 SocialDataX 笔记搜索 Owner: devinchen2014 Summary: 用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。 Tags: latest:0.1.18 Version history: v0.1.18 | 2026-08-11T07:25:24.683Z | user Restore Chinese ClawHub display name for XHS search visibility. v0.1.17 | 2026-08-05T03:24:20.388Z | user 同步 SocialDataX 多平台公开能力口径 v0.1.16 | 2026-07-29T10:50:32.752Z | user R","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.1K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s1777wgr53fwsangwq5485w3jd85913j:socialdatax-xhs-search","sourceUrl":"https://clawhub.ai/devinchen2014/socialdatax-xhs-search","homepage":"https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/devinchen2014/socialdatax-xhs-search","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":67,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。 Skill: 小红书数据分析 SocialDataX 笔记搜索 Owner: devinchen2014 Su"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:23:31.387Z","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-09T18:23:31.387Z","emptyReason":null},"stars":null,"forks":null,"downloads":2139,"packageName":null,"latestVersion":"0.1.18","tractionLabel":"2.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:23:31.387Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T18:23:31.387Z","lastCrawledAt":"2026-10-09T18:23:31.387Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T18:23:31.387Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.18","createdAt":"2026-08-11T07:25:24.683Z","changelog":"Restore Chinese ClawHub display name for XHS search visibility.","fileCount":3,"zipByteSize":4666},{"version":"0.1.17","createdAt":"2026-08-05T03:24:20.388Z","changelog":"同步 SocialDataX 多平台公开能力口径","fileCount":3,"zipByteSize":4315},{"version":"0.1.16","createdAt":"2026-07-29T10:50:32.752Z","changelog":"Refresh Skill batch handling and XHS parameter guidance.","fileCount":3,"zipByteSize":4365},{"version":"0.1.15","createdAt":"2026-07-29T09:59:22.191Z","changelog":"Refresh XHS parameter and bounded batch guidance.","fileCount":3,"zipByteSize":4296},{"version":"0.1.14","createdAt":"2026-07-20T11:28:56.902Z","changelog":"Refresh API Key guidance to the SocialDataX AI access page.","fileCount":3,"zipByteSize":4375},{"version":"0.1.13","createdAt":"2026-07-20T10:36:32.903Z","changelog":"Refresh API Key guidance to the SocialDataX AI access page.","fileCount":3,"zipByteSize":4201},{"version":"0.1.12","createdAt":"2026-07-20T08:14:00.492Z","changelog":"Add balance recharge guidance to generated SocialDataX Skill.","fileCount":3,"zipByteSize":4280},{"version":"0.1.11","createdAt":"2026-07-08T08:40:36.839Z","changelog":"Refresh generated SocialDataX Skill guidance with source attribution and latest CLI docs.","fileCount":3,"zipByteSize":4178}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1777wgr53fwsangwq5485w3jd85913j:socialdatax-xhs-search","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-socialdatax-xhs-search/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-xhs-search/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-xhs-search/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-xhs-search/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-xhs-search/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-xhs-search/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-09T22:50:56.498Z"}},"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-socialdatax-xhs-search/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-xhs-search/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-xhs-search/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-xhs-search/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-09T18:23:31.387Z","emptyReason":null},"readme":"Skill: 小红书数据分析 SocialDataX 笔记搜索\n\nOwner: devinchen2014\n\nSummary: 用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\n\nTags: latest:0.1.18\n\nVersion history:\n\nv0.1.18 | 2026-08-11T07:25:24.683Z | user\n\nRestore Chinese ClawHub display name for XHS search visibility.\n\nv0.1.17 | 2026-08-05T03:24:20.388Z | user\n\n同步 SocialDataX 多平台公开能力口径\n\nv0.1.16 | 2026-07-29T10:50:32.752Z | user\n\nRefresh Skill batch handling and XHS parameter guidance.\n\nv0.1.15 | 2026-07-29T09:59:22.191Z | user\n\nRefresh XHS parameter and bounded batch guidance.\n\nv0.1.14 | 2026-07-20T11:28:56.902Z | user\n\nRefresh API Key guidance to the SocialDataX AI access page.\n\nv0.1.13 | 2026-07-20T10:36:32.903Z | user\n\nRefresh API Key guidance to the SocialDataX AI access page.\n\nv0.1.12 | 2026-07-20T08:14:00.492Z | user\n\nAdd balance recharge guidance to generated SocialDataX Skill.\n\nv0.1.11 | 2026-07-08T08:40:36.839Z | user\n\nRefresh generated SocialDataX Skill guidance with source attribution and latest CLI docs.\n\nv0.1.10 | 2026-07-02T13:51:48.673Z | user\n\nRefresh ClawHub listing with socialdatax.com homepage and explicit Chinese display name.\n\nv0.1.9 | 2026-06-27T04:29:53.699Z | user\n\nRestore official SocialDataX homepage and update XHS page_token pagination guidance.\n\nv0.1.8 | 2026-06-19T08:49:22.045Z | user\n\nSwitch API Key guidance and homepage to https://socialdatax.52choujiang.com for temporary filing\n\nv0.1.7 | 2026-06-03T08:05:05.352Z | user\n\nRefresh generated SocialDataX skill guidance with current source configuration.\n\nv0.1.6 | 2026-05-25T12:42:06.451Z | user\n\nAdd attribution URL for SocialDataX API Key guidance.\n\nv0.1.5 | 2026-05-24T13:21:14.999Z | user\n\nSet explicit Chinese display name and keep bilingual API Key guidance.\n\nv0.1.4 | 2026-05-24T13:16:32.997Z | auto\n\n- Added a localized Chinese instruction on how to obtain and manage the API Key, emphasizing the use of the official domain and environment variable.\n- Clarified that only <https://socialdatax.com> should be provided for API key requests, and not to suggest alternate domains.\n\nv0.1.3 | 2026-05-24T12:22:22.500Z | auto\n\n- Clarified the API key instructions to state that <https://socialdatax.com> is the only official website for API access.\n- No functional or code changes; documentation update only.\n\nv0.1.2 | 2026-05-19T10:45:00.300Z | user\n\nPin API Key guidance to the official SocialDataX website.\n\nv0.1.1 | 2026-05-19T04:08:05.024Z | user\n\nImprove Chinese search keywords for data analysis and note search.\n\nv0.1.0 | 2026-05-18T15:00:21.463Z | user\n\nInitial OpenClaw marketplace skill.\n\nArchive index:\n\nArchive v0.1.18: 3 files, 4666 bytes\n\nFiles: skill-card.md (2269b), SKILL.md (6445b), _meta.json (142b)\n\nFile v0.1.18:SKILL.md\n\n---\nname: \"socialdatax-xhs-search\"\ndescription: \"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-xhs-search\"\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<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->\n\n# 小红书数据分析 SocialDataX 笔记搜索\n\nUse this skill when the user wants 小红书数据分析, 小红书笔记搜索, Xiaohongshu / XHS / RedNote note search, topic discovery, content planning, competitor research, market observation, or trend scanning.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/ai?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 <https://socialdatax.com/ai?from=clawhub>，按官网的 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 \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n```\n\nRequired arguments:\n\n- `--keyword <text>`: content research topic; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.\n- `--note-type <all|image|video>`: optional content format filter; default is `all`.\n- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.\n- `--pages <n>`: fetch and merge N search pages from the current starting point.\n- `--max-items <n>`: stop after collecting N search results.\n- `--since-days <1-365>`: keep only search results whose public `publish_time` is within the last N days; search remains bounded by `--pages`.\n- `--pretty`: output formatting only; it does not change the research topic or results.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-xhs-search`: 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\nSummarize visible evidence separately from interpretation. Focus on topic patterns, content angles, audience reactions, creator positioning, and useful examples when the user needs traceability.\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.\nWhen the user asks for recent topic research, prefer CLI `--since-days 7` or another user-specified day window; do not claim complete platform coverage beyond the fetched pages.\n\n## Troubleshooting\n\n- If an SDK/dependency, npm network, Node.js/npm/npx availability, permission, or missing runtime error appears, treat it as a local runtime, dependency installation, network, or agent authorization issue, not a SocialDataX API key or business data error. If the current environment has permission, install or restore automatically. When network or execution authorization is needed, ask the user to approve or finish authorization, then continue the same command; do not use public web search as a substitute for SocialDataX data.\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.18:_meta.json\n\n{\n  \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n  \"slug\": \"socialdatax-xhs-search\",\n  \"version\": \"0.1.18\",\n  \"publishedAt\": 1786433124683\n}\n\nFile v0.1.18:skill-card.md\n\n## Description:\n\n用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\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 agents use this skill to search Xiaohongshu/XHS/RedNote notes for topic discovery, content planning, competitor research, market observation, and trend scanning. It helps summarize visible search evidence separately from interpretation while preserving returned note identifiers and URLs.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill invokes a mutable npm package through npx, which can change between executions.\n\nMitigation: Use a constrained runtime and prefer a pinned, reviewed package version before deployment.\n\nRisk: Returned note URLs may include xsec_token query parameters that should be treated as sensitive.\n\nMitigation: Preserve exact URLs when required for functionality, but avoid sharing or storing them outside the intended workflow.\n\nRisk: The skill requires SOCIALDATAX_API_KEY at runtime.\n\nMitigation: Expose only the required API key to the skill process and avoid forwarding unrelated environment variables.\n\n## Reference(s):\n\n- [SocialDataX API access](https://socialdatax.com/ai?from=clawhub)\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, API calls, Guidance]\n\n**Output Format:** [Markdown summaries with inline shell commands and search-result references]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY and may include exact returned note URLs with xsec_token query parameters.]\n\n## Skill Version(s):\n\n0.1.18 (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.17: 3 files, 4315 bytes\n\nFiles: skill-card.md (2337b), SKILL.md (5913b), _meta.json (142b)\n\nFile v0.1.17:SKILL.md\n\n---\nname: \"socialdatax-xhs-search\"\ndescription: \"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-xhs-search\"\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<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->\n\n# 小红书数据分析 SocialDataX 笔记搜索\n\nUse this skill when the user wants 小红书数据分析, 小红书笔记搜索, Xiaohongshu / XHS / RedNote note search, topic discovery, content planning, competitor research, market observation, or trend scanning.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/ai?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 <https://socialdatax.com/ai?from=clawhub>，按官网的 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 \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n```\n\nRequired arguments:\n\n- `--keyword <text>`: content research topic; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.\n- `--note-type <all|image|video>`: optional content format filter; default is `all`.\n- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.\n- `--pages <n>`: fetch and merge N search pages from the current starting point.\n- `--max-items <n>`: stop after collecting N search results.\n- `--since-days <1-365>`: keep only search results whose public `publish_time` is within the last N days; search remains bounded by `--pages`.\n- `--pretty`: output formatting only; it does not change the research topic or results.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-xhs-search`: 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\nSummarize visible evidence separately from interpretation. Focus on topic patterns, content angles, audience reactions, creator positioning, and useful examples when the user needs traceability.\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.\nWhen the user asks for recent topic research, prefer CLI `--since-days 7` or another user-specified day window; do not claim complete platform coverage beyond the fetched pages.\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.17:_meta.json\n\n{\n  \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n  \"slug\": \"socialdatax-xhs-search\",\n  \"version\": \"0.1.17\",\n  \"publishedAt\": 1785900260388\n}\n\nFile v0.1.17:skill-card.md\n\n## Description:\n\nSearches Xiaohongshu, XHS, and RedNote notes through SocialDataX for keyword research, content analysis, competitor analysis, and trend scanning.\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, analysts, and developers use this skill to query XHS or RedNote notes by keyword via SocialDataX and summarize visible results for topic discovery, content planning, competitor research, market observation, and trend scanning.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill requires a SocialDataX API key and runs the SocialDataX npm package to perform searches.\n\nMitigation: Confirm trust in SocialDataX, install from the declared npm package, and provide the API key only through SOCIALDATAX_API_KEY.\n\nRisk: Search results may include traceability URLs and pagination tokens that lose value if truncated, normalized, or rebuilt.\n\nMitigation: Preserve returned note URLs, note IDs, and pagination tokens exactly when displaying, storing, forwarding, or reusing them.\n\nRisk: The skill fetches bounded search pages and may not represent complete platform coverage.\n\nMitigation: State the fetched scope in summaries and use page or recency limits that match the user's research request.\n\n## Reference(s):\n\n- [SocialDataX API access](https://socialdatax.com/ai?from=clawhub)\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search)\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 optional shell commands and API result summaries.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY; returned note URLs, note IDs, and pagination tokens should be preserved exactly when used.]\n\n## Skill Version(s):\n\n0.1.17 (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.16: 3 files, 4365 bytes\n\nFiles: skill-card.md (2474b), SKILL.md (5946b), _meta.json (142b)\n\nFile v0.1.16:SKILL.md\n\n---\nname: \"socialdatax-xhs-search\"\ndescription: \"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-xhs-search\"\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<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->\n\n# 小红书数据分析 SocialDataX 笔记搜索\n\nUse this skill when the user wants 小红书数据分析, 小红书笔记搜索, Xiaohongshu / XHS / RedNote note search, topic discovery, content planning, competitor research, market observation, or trend scanning.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/ai?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 <https://socialdatax.com/ai?from=clawhub>，按官网的 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 \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n```\n\nRequired arguments:\n\n- `--keyword <text>`: content research topic; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.\n- `--note-type <all|image|video>`: optional content format filter; default is `all`.\n- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.\n- `--pages <n>`: fetch and merge N search pages from the current starting point.\n- `--max-items <n>`: stop after collecting N search results.\n- `--since-days <1-365>`: keep only search results whose public `publish_time` is within the last N days; search remains bounded by `--pages`.\n- `--pretty`: output formatting only; it does not change the research topic or results.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-xhs-search`: 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\nSummarize visible evidence separately from interpretation. Focus on topic patterns, content angles, audience reactions, creator positioning, and useful examples when the user needs traceability.\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.\nWhen the user asks for recent topic research, prefer CLI `--since-days 7` or another user-specified day window; do not claim complete platform coverage beyond the fetched pages.\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.16:_meta.json\n\n{\n  \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n  \"slug\": \"socialdatax-xhs-search\",\n  \"version\": \"0.1.16\",\n  \"publishedAt\": 1785322232752\n}\n\nFile v0.1.16:skill-card.md\n\n## Description: <br>\nSearches Xiaohongshu/XHS/RedNote notes through SocialDataX for keyword research, content planning, competitor analysis, market observation, and trend scanning. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[devinchen2014](https://clawhub.ai/user/devinchen2014) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers, analysts, and content researchers use this skill to run SocialDataX-backed Xiaohongshu/XHS searches and summarize visible note evidence for topic discovery, content planning, competitor research, and trend analysis. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Search terms are sent to SocialDataX as third-party API calls. <br>\nMitigation: Use the skill only for SocialDataX-backed Xiaohongshu/XHS research, avoid sensitive search terms, and clarify intent when a request is generic research rather than XHS/RedNote-focused. <br>\nRisk: The skill depends on SOCIALDATAX_API_KEY at runtime. <br>\nMitigation: Keep the key in the environment, do not embed it in generated files or outputs, and confirm the configured account when balance or credit errors occur. <br>\nRisk: Fetched pages may not represent complete platform coverage. <br>\nMitigation: State the query bounds in summaries, use explicit page or recent-day windows when relevant, and separate visible evidence from interpretation. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search) <br>\n- [SocialDataX API access](https://socialdatax.com/ai?from=clawhub) <br>\n- [Publisher profile](https://clawhub.ai/user/devinchen2014) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, Shell commands, API calls, Guidance] <br>\n**Output Format:** [Markdown with CLI examples, parameter guidance, and summarized search results] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Read-only Xiaohongshu/XHS search using SOCIALDATAX_API_KEY; results may include note URLs and IDs that must be preserved exactly.] <br>\n\n## Skill Version(s): <br>\n0.1.16 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.1.15: 3 files, 4296 bytes\n\nFiles: skill-card.md (1990b), SKILL.md (5946b), _meta.json (142b)\n\nFile v0.1.15:SKILL.md\n\n---\nname: \"socialdatax-xhs-search\"\ndescription: \"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-xhs-search\"\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<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->\n\n# 小红书数据分析 SocialDataX 笔记搜索\n\nUse this skill when the user wants 小红书数据分析, 小红书笔记搜索, Xiaohongshu / XHS / RedNote note search, topic discovery, content planning, competitor research, market observation, or trend scanning.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/ai?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 <https://socialdatax.com/ai?from=clawhub>，按官网的 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 \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n```\n\nRequired arguments:\n\n- `--keyword <text>`: content research topic; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.\n- `--note-type <all|image|video>`: optional content format filter; default is `all`.\n- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.\n- `--pages <n>`: fetch and merge N search pages from the current starting point.\n- `--max-items <n>`: stop after collecting N search results.\n- `--since-days <1-365>`: keep only search results whose public `publish_time` is within the last N days; search remains bounded by `--pages`.\n- `--pretty`: output formatting only; it does not change the research topic or results.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-xhs-search`: 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\nSummarize visible evidence separately from interpretation. Focus on topic patterns, content angles, audience reactions, creator positioning, and useful examples when the user needs traceability.\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.\nWhen the user asks for recent topic research, prefer CLI `--since-days 7` or another user-specified day window; do not claim complete platform coverage beyond the fetched pages.\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.15:_meta.json\n\n{\n  \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n  \"slug\": \"socialdatax-xhs-search\",\n  \"version\": \"0.1.15\",\n  \"publishedAt\": 1785319162191\n}\n\nFile v0.1.15:skill-card.md\n\n## Description: <br>\n用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究，覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[devinchen2014](https://clawhub.ai/user/devinchen2014) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this skill to search Xiaohongshu / XHS / RedNote notes through SocialDataX for content research, competitor analysis, topic discovery, market observation, and trend scanning. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Search keywords and returned note URLs are handled by SocialDataX tooling using the user's SOCIALDATAX_API_KEY. <br>\nMitigation: Use the skill only for intended XHS research tasks, keep the API key in the environment, and avoid sending sensitive keywords unless that handling is acceptable. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search) <br>\n- [SocialDataX API Access](https://socialdatax.com/ai?from=clawhub) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, Shell commands, API calls, Guidance] <br>\n**Output Format:** [Markdown with CLI examples, parameter guidance, and summarized XHS search evidence] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY and node/npm; preserves returned note URLs and note IDs exactly when reporting results.] <br>\n\n## Skill Version(s): <br>\n0.1.15 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.1.14: 3 files, 4375 bytes\n\nFiles: skill-card.md (2441b), SKILL.md (5685b), _meta.json (142b)\n\nFile v0.1.14:SKILL.md\n\n---\nname: \"socialdatax-xhs-search\"\ndescription: \"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-xhs-search\"\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<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->\n\n# 小红书数据分析 SocialDataX 笔记搜索\n\nUse this skill when the user wants 小红书数据分析, 小红书笔记搜索, Xiaohongshu / XHS / RedNote note search, topic discovery, content planning, competitor research, market observation, or trend scanning.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/ai?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 <https://socialdatax.com/ai?from=clawhub>，按官网的 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 \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n```\n\nRequired arguments:\n\n- `--keyword <text>`: content research topic; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.\n- `--note-type <all|image|video>`: optional content format filter; default is `all`.\n- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.\n- `--pages <n>`: fetch and merge N search pages from the current starting point.\n- `--max-items <n>`: stop after collecting N search results.\n- `--since-days <1-365>`: keep only search results whose public `publish_time` is within the last N days; search remains bounded by `--pages`.\n- `--pretty`: output formatting only; it does not change the research topic or results.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-xhs-search`: 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\nSummarize visible evidence separately from interpretation. Focus on topic patterns, content angles, audience reactions, creator positioning, and useful examples when the user needs traceability.\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.\nWhen the user asks for recent topic research, prefer CLI `--since-days 7` or another user-specified day window; do not claim complete platform coverage beyond the fetched pages.\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.14:_meta.json\n\n{\n  \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n  \"slug\": \"socialdatax-xhs-search\",\n  \"version\": \"0.1.14\",\n  \"publishedAt\": 1784546936902\n}\n\nFile v0.1.14:skill-card.md\n\n## Description: <br>\n用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[devinchen2014](https://clawhub.ai/user/devinchen2014) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and agent developers use this skill to search Xiaohongshu / XHS / RedNote notes by keyword for content research, competitor analysis, market observation, and trend scanning through SocialDataX. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill sends XHS search queries and the SOCIALDATAX_API_KEY to SocialDataX. <br>\nMitigation: Use the skill only with an API key and queries that are appropriate to share with SocialDataX. <br>\nRisk: Returned note_url values may include xsec_token query parameters that are preserved in outputs. <br>\nMitigation: Review exported, forwarded, or published results before sharing them outside the intended audience. <br>\nRisk: Search results are bounded by requested pages and filters, so they may not represent complete platform coverage. <br>\nMitigation: Describe results as based on fetched pages and keep visible evidence separate from interpretation. <br>\n\n\n## Reference(s): <br>\n- [SocialDataX AI access page](https://socialdatax.com/ai?from=clawhub) <br>\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search) <br>\n- [ClawHub publisher profile](https://clawhub.ai/user/devinchen2014) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with inline shell commands and search-result summaries] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Search outputs may include full note_url values with xsec_token query parameters and complete 24-character note_id values.] <br>\n\n## Skill Version(s): <br>\n0.1.14 (source: server-resolved release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.1.13: 3 files, 4201 bytes\n\nFiles: skill-card.md (2339b), SKILL.md (5685b), _meta.json (142b)\n\nFile v0.1.13:SKILL.md\n\n---\nname: \"socialdatax-xhs-search\"\ndescription: \"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-xhs-search\"\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<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->\n\n# 小红书数据分析 SocialDataX 笔记搜索\n\nUse this skill when the user wants 小红书数据分析, 小红书笔记搜索, Xiaohongshu / XHS / RedNote note search, topic discovery, content planning, competitor research, market observation, or trend scanning.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/ai?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 <https://socialdatax.com/ai?from=clawhub>，按官网的 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 \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n```\n\nRequired arguments:\n\n- `--keyword <text>`: content research topic; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.\n- `--note-type <all|image|video>`: optional content format filter; default is `all`.\n- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.\n- `--pages <n>`: fetch and merge N search pages from the current starting point.\n- `--max-items <n>`: stop after collecting N search results.\n- `--since-days <1-365>`: keep only search results whose public `publish_time` is within the last N days; search remains bounded by `--pages`.\n- `--pretty`: output formatting only; it does not change the research topic or results.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-xhs-search`: 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\nSummarize visible evidence separately from interpretation. Focus on topic patterns, content angles, audience reactions, creator positioning, and useful examples when the user needs traceability.\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.\nWhen the user asks for recent topic research, prefer CLI `--since-days 7` or another user-specified day window; do not claim complete platform coverage beyond the fetched pages.\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.13:_meta.json\n\n{\n  \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n  \"slug\": \"socialdatax-xhs-search\",\n  \"version\": \"0.1.13\",\n  \"publishedAt\": 1784543792903\n}\n\nFile v0.1.13:skill-card.md\n\n## Description: <br>\nSearches Xiaohongshu, XHS, and RedNote notes through SocialDataX for keyword research, content planning, competitor analysis, market observation, and trend scanning. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[devinchen2014](https://clawhub.ai/user/devinchen2014) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this read-only skill to search Xiaohongshu notes with a SocialDataX API key for topic discovery, content planning, competitor research, market observation, and trend scanning. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Search topics are sent to SocialDataX when the skill is used. <br>\nMitigation: Install and run the skill only when the user is comfortable using a SocialDataX API key and sending XHS search topics to that service. <br>\nRisk: Returned note URLs may include xsec_token query parameters that are preserved for traceability. <br>\nMitigation: Treat preserved result URLs as traceable data and avoid sharing or storing them outside the intended workflow. <br>\nRisk: The skill depends on a runtime API key. <br>\nMitigation: Use SOCIALDATAX_API_KEY from the user's environment and do not place API keys in generated skill files or public output. <br>\n\n\n## Reference(s): <br>\n- [SocialDataX AI access page](https://socialdatax.com/ai?from=clawhub) <br>\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search) <br>\n- [ClawHub publisher profile](https://clawhub.ai/user/devinchen2014) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, Shell commands, API Calls, Guidance] <br>\n**Output Format:** [Markdown guidance with shell command examples and summarized search results] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY and preserves returned note URLs exactly for traceability.] <br>\n\n## Skill Version(s): <br>\n0.1.13 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.1.12: 3 files, 4280 bytes\n\nFiles: skill-card.md (2203b), SKILL.md (5679b), _meta.json (142b)\n\nFile v0.1.12:SKILL.md\n\n---\nname: \"socialdatax-xhs-search\"\ndescription: \"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-xhs-search\"\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<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->\n\n# 小红书数据分析 SocialDataX 笔记搜索\n\nUse this skill when the user wants 小红书数据分析, 小红书笔记搜索, Xiaohongshu / XHS / RedNote note search, topic discovery, content planning, competitor research, market observation, or trend scanning.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 <https://socialdatax.com/?from=clawhub>，按官网的 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 \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n```\n\nRequired arguments:\n\n- `--keyword <text>`: content research topic; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.\n- `--note-type <all|image|video>`: optional content format filter; default is `all`.\n- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.\n- `--pages <n>`: fetch and merge N search pages from the current starting point.\n- `--max-items <n>`: stop after collecting N search results.\n- `--since-days <1-365>`: keep only search results whose public `publish_time` is within the last N days; search remains bounded by `--pages`.\n- `--pretty`: output formatting only; it does not change the research topic or results.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-xhs-search`: 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\nSummarize visible evidence separately from interpretation. Focus on topic patterns, content angles, audience reactions, creator positioning, and useful examples when the user needs traceability.\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.\nWhen the user asks for recent topic research, prefer CLI `--since-days 7` or another user-specified day window; do not claim complete platform coverage beyond the fetched pages.\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.12:_meta.json\n\n{\n  \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n  \"slug\": \"socialdatax-xhs-search\",\n  \"version\": \"0.1.12\",\n  \"publishedAt\": 1784535240492\n}\n\nFile v0.1.12:skill-card.md\n\n## Description: <br>\n用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[devinchen2014](https://clawhub.ai/user/devinchen2014) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users, analysts, marketers, and agents use this skill to search Xiaohongshu / XHS / RedNote notes by keyword, inspect visible search evidence, and summarize patterns for content planning, competitor research, market observation, and trend scanning. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Search keywords and the SocialDataX API key are sent through the SocialDataX npm/API workflow. <br>\nMitigation: Use the skill only when that data flow is acceptable, keep SOCIALDATAX_API_KEY in the environment, and obtain or manage keys only through the listed SocialDataX homepage. <br>\nRisk: Returned XHS note URLs may contain full query parameters that the skill instructs agents to preserve. <br>\nMitigation: Share or store returned URLs only when appropriate for the use case, and avoid altering URLs or note IDs when traceability is required. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search) <br>\n- [SocialDataX API access and homepage](https://socialdatax.com/?from=clawhub) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, guidance] <br>\n**Output Format:** [Markdown summaries with optional shell command examples and preserved source URLs] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY and node/npm; preserves returned note URLs and pagination tokens exactly when used.] <br>\n\n## Skill Version(s): <br>\n0.1.12 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.1.11: 3 files, 4178 bytes\n\nFiles: skill-card.md (2489b), SKILL.md (5002b), _meta.json (142b)\n\nFile v0.1.11:SKILL.md\n\n---\nname: \"socialdatax-xhs-search\"\ndescription: \"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-xhs-search\"\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<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->\n\n# 小红书数据分析 SocialDataX 笔记搜索\n\nUse this skill when the user wants 小红书数据分析, 小红书笔记搜索, Xiaohongshu / XHS / RedNote note search, topic discovery, content planning, competitor research, market observation, or trend scanning.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 <https://socialdatax.com/?from=clawhub>，按官网的 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 --keyword \"<keyword>\" --pretty --source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-xhs-search\nnpx -y socialdatax-skills@latest xhs search --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-xhs-search\n```\n\nRequired arguments:\n\n- `--keyword <text>`: content research topic; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.\n- `--note-type <all|image|video>`: optional content format filter; default is `all`.\n- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.\n- `--pages <n>`: fetch and merge N search pages from the current starting point.\n- `--max-items <n>`: stop after collecting N search results.\n- `--since-days <1-365>`: keep only search results whose public `publish_time` is within the last N days; search remains bounded by `--pages`.\n- `--pretty`: output formatting only; it does not change the research topic or results.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-xhs-search`: 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\nSummarize visible evidence separately from interpretation. Focus on topic patterns, content angles, audience reactions, creator positioning, and useful examples when the user needs traceability.\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.\nWhen the user asks for recent topic research, prefer CLI `--since-days 7` or another user-specified day window; do not claim complete platform coverage beyond the fetched pages.\n\nFile v0.1.11:_meta.json\n\n{\n  \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n  \"slug\": \"socialdatax-xhs-search\",\n  \"version\": \"0.1.11\",\n  \"publishedAt\": 1783500036839\n}\n\nFile v0.1.11:skill-card.md\n\n## Description: <br>\n用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[devinchen2014](https://clawhub.ai/user/devinchen2014) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users, developers, and analysts use this skill to search Xiaohongshu/XHS/RedNote notes through SocialDataX for keyword research, content planning, competitor analysis, market observation, and trend scanning. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill sends search keywords to SocialDataX using the user's API key. <br>\nMitigation: Use only appropriate search terms, configure SOCIALDATAX_API_KEY intentionally, and avoid placing secrets or private data in keywords. <br>\nRisk: Returned XHS note URLs may contain xsec_token query parameters that behave like sensitive result links. <br>\nMitigation: Preserve URLs exactly when traceability is required, but avoid sharing or storing them in public or long-term shared channels unless the exact result URL is intended to be shared. <br>\nRisk: Search output is bounded by requested pages and filters, so it may not represent complete Xiaohongshu platform coverage. <br>\nMitigation: State the fetched page or time-window limits and keep trend or competitor conclusions tied to the retrieved evidence. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search) <br>\n- [SocialDataX API Homepage](https://socialdatax.com/?from=clawhub) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, guidance] <br>\n**Output Format:** [Markdown summaries with CLI command guidance and exact returned XHS note URLs when cited.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY; preserves returned note_url and 24-character note_id values exactly.] <br>\n\n## Skill Version(s): <br>\n0.1.11 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.1.10: 3 files, 4065 bytes\n\nFiles: skill-card.md (2617b), SKILL.md (4447b), _meta.json (142b)\n\nFile v0.1.10:SKILL.md\n\n---\nname: \"socialdatax-xhs-search\"\ndescription: \"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\"\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<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->\n\n# 小红书数据分析 SocialDataX 笔记搜索\n\nUse this skill when the user wants 小红书数据分析, 小红书笔记搜索, Xiaohongshu / XHS / RedNote note search, topic discovery, content planning, competitor research, market observation, or trend scanning.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 <https://socialdatax.com/?from=clawhub>，按官网的 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 --keyword \"<keyword>\" --pretty\nnpx -y socialdatax-skills@latest xhs search --keyword \"<keyword>\" --pages 3 --pretty\n```\n\nRequired arguments:\n\n- `--keyword <text>`: content research topic; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.\n- `--note-type <all|image|video>`: optional content format filter; default is `all`.\n- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.\n- `--pages <n>`: fetch and merge N search pages from the current starting point.\n- `--max-items <n>`: stop after collecting N search results.\n- `--since-days <1-365>`: keep only search results whose public `publish_time` is within the last N days; search remains bounded by `--pages`.\n- `--pretty`: output formatting only; it does not change the research topic or results.\n\n## Safety Boundary\n\nThis skill is read-only. It does not read local browser data, does not perform login, posting, liking, commenting, or account changes. The local CLI and installer do not write API keys to local files.\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\nSummarize visible evidence separately from interpretation. Focus on topic patterns, content angles, audience reactions, creator positioning, and useful examples when the user needs traceability.\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.\nWhen the user asks for recent topic research, prefer CLI `--since-days 7` or another user-specified day window; do not claim complete platform coverage beyond the fetched pages.\n\nFile v0.1.10:_meta.json\n\n{\n  \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n  \"slug\": \"socialdatax-xhs-search\",\n  \"version\": \"0.1.10\",\n  \"publishedAt\": 1783000308673\n}\n\nFile v0.1.10:skill-card.md\n\n## Description: <br>\n用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[devinchen2014](https://clawhub.ai/user/devinchen2014) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal analysts, marketers, researchers, and content teams use this skill to search Xiaohongshu / XHS / RedNote notes for keyword research, topic discovery, content planning, competitor research, market observation, and trend scanning. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Search keywords and the SOCIALDATAX_API_KEY are sent to SocialDataX tooling. <br>\nMitigation: Install and run the skill only when SocialDataX is a trusted service for the intended use case, and provide the API key through the documented SOCIALDATAX_API_KEY environment variable. <br>\nRisk: Returned note URLs may contain xsec_token query parameters that could be sensitive if broadly shared or logged. <br>\nMitigation: Avoid unnecessary redistribution or logging of full returned note URLs, and share results only with audiences authorized to receive those links. <br>\nRisk: Recent-topic findings may not represent complete platform coverage beyond fetched pages. <br>\nMitigation: Use bounded page and recency parameters such as --pages and --since-days, and describe findings as observations from the fetched result set. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill listing](https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search) <br>\n- [SocialDataX homepage](https://socialdatax.com/?from=clawhub) <br>\n- [ClawHub publisher profile](https://clawhub.ai/user/devinchen2014) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with inline shell commands and summarized XHS search evidence] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Preserve returned note URLs and pagination tokens exactly; recent topic research is bounded by fetched pages.] <br>\n\n## Skill Version(s): <br>\n0.1.10 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.1.9: 3 files, 3804 bytes\n\nFiles: skill-card.md (2424b), SKILL.md (4088b), _meta.json (141b)\n\nFile v0.1.9:SKILL.md\n\n---\nname: \"socialdatax-xhs-search\"\ndescription: \"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\"\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<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->\n\n# 小红书数据分析 SocialDataX 笔记搜索\n\nUse this skill when the user wants 小红书数据分析, 小红书笔记搜索, Xiaohongshu / XHS / RedNote note search, topic discovery, content planning, competitor research, market observation, or trend scanning.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 <https://socialdatax.com/?from=clawhub>，按官网的 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 --keyword \"<keyword>\" --pretty\nnpx -y socialdatax-skills@latest xhs search --keyword \"<keyword>\" --pages 3 --pretty\n```\n\nRequired arguments:\n\n- `--keyword <text>`: content research topic; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.\n- `--note-type <all|image|video>`: optional content format filter; default is `all`.\n- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.\n- `--pages <n>`: fetch and merge N search pages from the current starting point.\n- `--max-items <n>`: stop after collecting N search results.\n- `--pretty`: output formatting only; it does not change the research topic or results.\n\n## Safety Boundary\n\nThis skill is read-only. It does not read local browser data, does not save API keys, and does not 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\nSummarize visible evidence separately from interpretation. Focus on topic patterns, content angles, audience reactions, creator positioning, and useful examples when the user needs traceability.\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.9:_meta.json\n\n{\n  \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n  \"slug\": \"socialdatax-xhs-search\",\n  \"version\": \"0.1.9\",\n  \"publishedAt\": 1782534593699\n}\n\nFile v0.1.9:skill-card.md\n\n## Description: <br>\n用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[devinchen2014](https://clawhub.ai/user/devinchen2014) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this skill to search Xiaohongshu / XHS / RedNote notes for topic discovery, content planning, competitor research, market observation, and trend scanning through SocialDataX. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill uses a third-party SocialDataX service and npm package. <br>\nMitigation: Confirm the user trusts the SocialDataX service and the socialdatax-skills npm package before installation or use. <br>\nRisk: The skill requires a SOCIALDATAX_API_KEY for data calls. <br>\nMitigation: Provide only the intended API key through the SOCIALDATAX_API_KEY environment variable and avoid exposing it in prompts, logs, or shared output. <br>\nRisk: Returned note URLs can include xsec_token-bearing links that may be private or sensitive. <br>\nMitigation: Avoid publicly sharing returned note URLs when those token-bearing links should remain private. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search) <br>\n- [SocialDataX homepage](https://socialdatax.com/?from=clawhub) <br>\n- [Publisher profile](https://clawhub.ai/user/devinchen2014) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with CLI commands, MCP tool guidance, and summarized search findings] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Search output may include note URLs with xsec_token query parameters that should be preserved exactly when traceability is needed.] <br>\n\n## Skill Version(s): <br>\n0.1.9 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>","readmeExcerpt":"Skill: 小红书数据分析 SocialDataX 笔记搜索 Owner: devinchen2014 Summary: 用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。 Tags: latest:0.1.18 Version history: v0.1.18 | 2026-08-11T07:25:24.683Z | user Restore Chinese ClawHub display name for XHS search visibility. v0.1.17 | 2026-08-05T03:24:20.388Z | user 同步 SocialDataX 多平台公开能力口径 v0.1.16 | 2026-07-29T10:50:32.752Z | user R","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"socialdatax-xhs-search\"\ndescription: \"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-xhs-search\"\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<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->\n\n# 小红书数据分析 SocialDataX 笔记搜索\n\nUse this skill when the user wants 小红书数据分析, 小红书笔记搜索, Xiaohongshu / XHS / RedNote note search, topic discovery, content planning, competitor research, market observation, or trend scanning.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/ai?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 <https://socialdatax.com/ai?from=clawhub>，按官网的 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 \"<keyword>\" --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n\nnpx -y socialdatax-skills@latest xhs search \\\n  --keyword \"<keyword>\" --pages 3 --pretty --source-client socialdatax-skills \\\n  --source-platform clawhub --source-skill socialdatax-xhs-search\n```\n\nRequired arguments:\n\n- `--keyword <text>`: content research topic; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.\n- `--note-type <all|image|video>`: optional content format filter; default is `all`.\n- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.\n- `--pages <n>`: fetch and merge N search pages from the current starting point.\n- `--max-items <n>`: stop after collecting N search results.\n- `--since-days <1-365>`: keep only search results whose public `publish_time` is within the last N days; search remains bounded by `--pages`.\n- `--pretty`: output formatting only; it does not change the research topic or results.\n- `--source-client socialdatax-skills --"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n  \"slug\": \"socialdatax-xhs-search\",\n  \"version\": \"0.1.18\",\n  \"publishedAt\": 1786433124683\n}"},{"path":"skill-card.md","content":"## Description:\n\n用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。\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 agents use this skill to search Xiaohongshu/XHS/RedNote notes for topic discovery, content planning, competitor research, market observation, and trend scanning. It helps summarize visible search evidence separately from interpretation while preserving returned note identifiers and URLs.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill invokes a mutable npm package through npx, which can change between executions.\n\nMitigation: Use a constrained runtime and prefer a pinned, reviewed package version before deployment.\n\nRisk: Returned note URLs may include xsec_token query parameters that should be treated as sensitive.\n\nMitigation: Preserve exact URLs when required for functionality, but avoid sharing or storing them outside the intended workflow.\n\nRisk: The skill requires SOCIALDATAX_API_KEY at runtime.\n\nMitigation: Expose only the required API key to the skill process and avoid forwarding unrelated environment variables.\n\n## Reference(s):\n\n- [SocialDataX API access](https://socialdatax.com/ai?from=clawhub)\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-xhs-search)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, API calls, Guidance]\n\n**Output Format:** [Markdown summaries with inline shell commands and search-result references]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY and may include exact returned note URLs with xsec_token query parameters.]\n\n## Skill Version(s):\n\n0.1.18 (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":"用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。 Skill: 小红书数据分析 SocialDataX 笔记搜索 Owner: devinchen2014 Summary: 用于小红书数据分析、小红书笔记搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Xiaohongshu / XHS / RedNote note search，来自 SocialDataX 社媒数据助手。 Tags: latest:0.1.18 Version history: v0.1.18 | 2026-08-11T07:25:24.683Z | user Restore Chinese ClawHub display name for XHS search visibility. v0.1.17 | 2026-08-05T03:24:20.388Z | user 同步 SocialDataX 多平台公开能力口径 v0.1.16 | 2026-07-29T10:50:32.752Z | user R","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1039,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T18:23:31.387Z","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-09T18:23:31.387Z","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-09T22:50:56.500Z","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"}]}}}