SKILL.md

---
name: socialdatax-xhs-detail
description: 用于小红书数据分析、小红书笔记详情、笔记数据、互动指标、内容调研和内容分析。覆盖 Xiaohongshu / XHS / RedNote note details，来自 SocialDataX 社媒数据助手。
metadata: {"openclaw":{"requires":{"env":["SOCIALDATAX_API_KEY"],"bins":["node","npm"]},"primaryEnv":"SOCIALDATAX_API_KEY","emoji":"📄","homepage":"https://socialdatax.com/?from=clawhub","install":[{"kind":"node","package":"socialdatax-skills","bins":[]}]}}
---

# 小红书数据分析 SocialDataX 笔记详情

Use this skill when the user provides a Xiaohongshu / 小红书 / XHS / RedNote note ID, note URL, short link, or share text and wants 小红书数据分析, 笔记详情, structured note data, or interaction metrics.

## API Key

Use `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.
获取或管理 API Key：访问 <https://socialdatax.com/?from=clawhub>，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。

## Preferred Direct CLI

Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:

```bash
npx -y socialdatax-skills@latest xhs detail --note-id "<note_id>" --pretty
npx -y socialdatax-skills@latest xhs detail --url "<note_url_or_share_text_or_note_id>" --pretty
```

- `--note-id <note_id>`: preferred when the note ID is already known from search, comments, or a previous detail result.
- `--url <note_url_or_share_text_or_note_id>`: use for a note link, short link, share text, or note ID when you want the alternate entrypoint for one note.
- `--pretty`: output formatting only.

Use either `--note-id` or `--url` for one detail command, not both.

## Safety Boundary

This 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.

## MCP Tools

If MCP tools are already available in the current agent, use one of these tools:

- `xhs_get_note_detail_by_note_id`: use when a note ID is already known.
- `xhs_get_note_detail_by_note_url`: use for note URLs, short links, share text, or note IDs.

## Output Guidance

Return factual fields such as title, content, author, publish time, interaction counts, images, and note URL when available. Separate note facts from strategic interpretation.