前言¶

品牌、内容运营和创作者在微博上做竞品观察时，常见做法是手动搜关键词、截图留存、再在表格里拼结论。样本难追溯、翻页成本高，策略对比也容易变成主观印象。下面介绍 SkillHub 上的社区 Skill「微博竞品研究」（@user_825d9e7e/weibo-competitor-research），它把「按关键词拉取微博搜索结果并整理成可复盘材料」写进通用 SKILL.md 工作流，由 Agent 在对话里按场景触发并调用底层 CLI。

这是什么¶

「微博竞品研究」是面向 微博竞品研究、同赛道观察、内容角度对比、内容策略对比、品牌内容调研 的 Agent Skill。坐标为 @user_825d9e7e/weibo-competitor-research，当前版本 1.0.8，来源为 community，分类 data-analysis，由发布者 user_825d9e7e 维护。SkillHub 页面标注 requires_api_key=true：运行依赖环境变量 SOCIALDATAX_API_KEY（需在 SocialDataX 申请或管理，域名以 Skill 说明为准）。

与纯网页搜索不同，该 Skill 约定通过 socialdatax-skills 的 weibo search 拉取结构化 JSON，并保留帖子 ID、链接、作者与互动等字段，便于后续做角度归纳和策略对比。

核心功能¶

以下能力来自 Skill 包内 SKILL.md（与 SkillHub 简介一致，经 Skills Directory 公开镜像核对）：

1. 关键词搜索：以用户真实意图为关键词，调用微博帖子搜索；支持先取一页样本，再分页或限量扩大范围。
2. 分页与限量：可选 --pages、--max-items、--page-token（续页须原样传回完整 next_page_token）；搜索不支持 --all。
3. 输出形态：命令返回 JSON（含 platform、tool、arguments、data）；多页结果合并到 data.items，并附带 page_count、item_count 与下一页标记。
4. MCP 对应：与 CLI 等价的工具名为 weibo_search_posts；能跑 shell 的 Agent 可优先 direct CLI，不必单独配 MCP。
5. 安全边界：只读；不登录、不发帖、不点赞、不评论；API Key 仅来自用户环境变量，不写进 Skill 文件。

安装与启用¶

通过 SkillHub 安装（推荐）¶

官方页面给出的安装提示为：让 AI 按 SkillHub 安装文档 安装本 Skill。文档中的通用流程如下。

先确认是否已安装 skillhub CLI：

command -v skillhub && skillhub --version

未安装时可执行完整安装（需联网）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。Cursor 常用路径为 ~/.cursor/skills/：

skillhub install @user_825d9e7e/weibo-competitor-research --dir ~/.cursor/skills/

也可将安装提示原样发给 Agent：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_825d9e7e/weibo-competitor-research`。

API Key 与运行依赖¶

在 shell 或 Agent 环境中配置：

export SOCIALDATAX_API_KEY="你的密钥"

Skill 元数据要求本机具备 node、npm（用于 npx 调用 socialdatax-skills 包）。Codex、Claude Code 等客户端的 skills 目录与 Cursor 不同，安装时把 --dir 换成对应路径即可；各路径以 安装文档 第四节为准。

Claude Code 可选安装方式¶

Skills Directory 为同一 Skill 提供了基于上游仓库的安装命令（安装到当前项目的 .claude/skills）：

npx -y skills add DevinChen2014/socialdatax-skills --skill weibo-competitor-research --agent claude-code

若你主要使用 SkillHub 坐标，仍以 skillhub install 与官方页面说明为准。

典型用法¶

1. 在对话中触发 Skill¶

当任务属于微博竞品分析、同赛道观察或品牌内容调研时，直接说明关键词或选题方向即可。Skill 建议：先看一页样本，再决定是否用 --max-items 或 --pages 扩大。

示例提示（可复现意图，非固定话术）：

用微博竞品研究 Skill，关键词「新能源汽车 试驾」，先拉一页搜索结果，列出标题、作者、链接，并归纳 3 个内容角度差异。

2. 直接调用 CLI（Agent 或本地终端）¶

Skill 推荐优先使用 direct CLI，并保持来源标记参数不变：

npx -y socialdatax-skills@latest weibo search \
  --keyword "新能源汽车 试驾" \
  --pretty \
  --source-client socialdatax-skills \
  --source-platform modelscope \
  --source-skill weibo-competitor-research

需要更多样本时，可在同一搜索链路上增加 --max-items <N> 或 --pages <N>；若返回 next_page_token，续查时使用 --page-token <next_page_token>，且 token 不得截断或改写。

3. 整理结论时的输出习惯¶

Skill 建议将「可见证据」与「判断」分开：需要可追溯时保留 post_id、post_url、作者、互动数据与发布时间，并标出可继续追问的问题。这样从单条关键词搜索延伸到多账号、多角度的策略对比时，仍有据可查。

适用场景与注意¶

适合谁：品牌与市场同学做微博竞品与内容策略对比；内容运营与创作者做同赛道选题与角度观察。

平台数据：SkillHub 显示评分 100000，下载 2223（统计以页面为准，会随时间变化）。

限制与常见坑：

• 未配置 SOCIALDATAX_API_KEY 或余额不足（insufficient_balance）会导致调用失败；余额类错误应按返回中的充值指引处理，不宜盲目重试。
• 某一页 items 为空不代表没有更多结果；无结果时可放宽或改写关键词。
• 依赖 Node/npm 与网络；SDK 或 npx 环境问题属于本地运行环境，与 API Key 业务错误需区分处理。
• 搜索有边界，不支持一次拉取「全部」结果；大范围竞品扫描应分关键词、分批次进行。

结尾¶

「微博竞品研究」把微博关键词搜索、分页取样和可追溯字段保留写进 Agent 可执行流程，适合需要 同赛道观察 和 内容策略对比 的团队。安装与坐标以 SkillHub 为准：

• 技能页：https://www.skillhub.cn/skills/user_825d9e7e/weibo-competitor-research
• API 入口：https://api.skillhub.cn/user_825d9e7e/weibo-competitor-research