x-twitter-content-researchlisted
Install: claude install-skill DevinChen2014/socialdatax-skills
<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->
# X / Twitter内容研究
## 适用场景
当用户需要做 X / Twitter 内容研究、账号内容观察、竞品内容对比、趋势判断或素材整理时使用。面向内容运营、品牌调研和创作者。
## 快速开始
- 先给出当前 skill 支持的输入:关键词或选题方向。
- 如果你只想先看样本,先取 1 页;要继续扩大,再按参数说明使用分页或 `--max-items`。
- 你通常会得到:相关标题、作者或账号、链接或内容 ID,以及可继续追问的角度。
## API Key 获取
获取或管理 API Key:访问 <https://socialdatax.com/ai?from=modelscope>,按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`;不要引导用户使用其他域名。
## 直接调用命令
优先使用 direct CLI;能运行 shell 命令的 Agent 不需要额外配置 MCP server:
```bash
npx -y socialdatax-skills@latest x search \
--keyword "<keyword>" --pretty --source-client socialdatax-skills \
--source-platform modelscope --source-skill x-twitter-content-research
```
## 参数说明
搜索:
- 说明:X / Twitter `search --keyword <text>`:使用 `x search` 时必填;使用用户真实意图,去掉多余空格,并保持关键词聚焦。
- 可选:`--max-items <n>`:收集到 N 条搜索结果后停止。
- 说明:X / Twitter `--sort-type <hot|time_descending>`:可选排序参数;不传就使用默认排序。
- 说明:X / Twitter `--pages <n>`:从当前起点继续获取并合并 N 页搜索结果;如果返回了 `next_page_token`,可继续续页。
通用:
- 可选:`--pretty`:只影响输出格式,不改变实际请求结果。
- 说明:X / Twitter `--page-token <next_page_token>`:这是不透明的分页 token;第一页不要传。继续同一条搜索链路时,只能原样传回完整返回的 `next_page_token`。
- 可选:`--source-client socialdatax-skills --source-platform modelscope --source-skill x-twitter-content-research`:这是当前 Agent Skill 的来源标记;按本 Skill 示例执行时保持这些值不变。
命令返回 JSON,包含 `platform`、`tool`、`arguments` 和 `data`。搜索支持 `--pages` 和 `--max-items`,但不支持 `--all`,因为搜索没有稳定的完整结果边界。多页结果会把