前言¶

品牌、內容運營和創作者在微博上做競品觀察時，常見做法是手動搜關鍵詞、截圖留存、再在表格裏拼結論。樣本難追溯、翻頁成本高，策略對比也容易變成主觀印象。下面介紹 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