前言¶

做品牌監測、競品動態收集或內部知識庫沉澱時，最耗時的一步往往不是分析，而是把公衆號文章一篇篇抓下來：搜索結果頁只能看到標題，點進去還要處理反爬、驗證碼和 IP 地域限制，正文、作者、發佈日期很難一次性結構化拿到。

下面介紹的 wechat-article-search-api-skill 就是針對這個環節的：輸入關鍵詞和可選的發佈日期，直接拿到結構化的公衆號文章全文。

這是什麼¶

wechat-article-search-api-skill 是一個基於 BrowserAct WeChat Article Search API 模板的採集工作流，由 ClawHub 上的 @ccmagia2-gif 發佈維護，版本 v1.0.1，License 爲 MIT-0。

它把「搜索微信文章」和「提取正文」兩件事合併成一次腳本調用，用預置的瀏覽器自動化工作流執行，不依賴大模型現場生成內容，因此結果穩定、可復現。

官方地址：https://api.skillhub.cn/org-b6kzcl68/wechat-article-search-api-skill
上游倉庫：https://clawhub.ai/ccmagia2-gif/wechat-article-search-api-skill

核心功能¶

官方 SKILL.md 列出的能力如下：

1、按關鍵詞搜索公衆號文章，可附加發布日期篩選。
2、返回結構化字段：原文鏈接、發佈日期、作者或公衆號名稱、封面圖地址、完整正文、標題。
3、預置工作流避免 AI 幻覺，數據提取穩定。
4、不需要處理驗證碼（reCAPTCHA 等）。
5、不需要處理 IP 地域限制或 geo-blocking。
6、相比純 AI 驅動的瀏覽器自動化，執行更快，且數據獲取成本更低。
7、內置一次性自動重試。

安裝與啓用¶

官方頁面給出的安裝命令是 ClawHub / OpenClaw 生態的 CLI 安裝方式：

openclaw skills install @ccmagia2-gif/wechat-article-search-api-skill

頁面同時標註了 npx skills 這條 CLI 入口。安裝完成後，Agent 在遇到相關需求時應主動加載該技能。

需要說明的是：官方資料裏沒有給出 Cursor、Codex CLI、Claude Code 各自的專用安裝命令，本文不臆測，只寫已覈實到的上述方式。

配置 API Key¶

這個 Skill 依賴 BrowserAct API，運行前需要檢查環境變量 BROWSERACT_API_KEY。

官方流程是：

1、檢查 BROWSERACT_API_KEY 是否已設置。
2、如果沒有設置，不要自行採取其他動作，向用戶索取並等待。
3、告知用戶：

Since you have not configured the BrowserAct API Key, please go to the BrowserAct Console to get your Key.

也就是用戶需要到 BrowserAct Console 自行申請 Key，Agent 不做代填。

輸入參數¶

調用腳本時，Agent 應根據用戶需求配置以下參數。

keywords，搜索關鍵詞，字符串類型。可以是行業詞、話題詞或具體短語，例如 openclaw、AI agent、browser automation。

Date_limit，提取數量上限，數值類型。默認值 10；官方建議首次運行用 5 到 10 做快速驗證，批量研究時再放大。

publication_date，發佈日期篩選，字符串類型。支持 3月11日、March 10、2026-03-11 等寫法。

典型用法¶

官方給出的調用方式是一條獨立腳本，「一條命令，直接出結果」：

python -u ./scripts/wechat_article_search_api.py "keywords" limit "publication_date"

例如按關鍵詞采集、數量上限 10、不篩日期：

python -u ./scripts/wechat_article_search_api.py "AI agent" 10

加上發佈日期篩選：

python -u ./scripts/wechat_article_search_api.py "AI agent" 10 "2026-03-11"

路徑 ./scripts/wechat_article_search_api.py 是技能包內相對路徑，需要在技能安裝目錄下執行。

運行狀態與輸出¶

由於這是瀏覽器自動化任務，單次運行可能持續數分鐘。腳本會持續輸出帶時間戳的狀態日誌，例如：

[14:30:05] Task Status: running

官方給 Agent 的判斷標準是：只要終端還在持續輸出新的狀態日誌，就說明任務在正常推進，不要誤判爲死鎖或無響應；只有在狀態長時間不變、或腳本停止輸出卻沒有返回結果時，才考慮觸發重試。

運行成功後，腳本直接解析並打印 API 響應，包含以下字段：

1、url_link：原文鏈接。
2、publication_date：文章發佈日期。
3、author：文章作者或發佈公衆號名稱。
4、image_url：文章主圖或封面圖地址。
5、body_content：完整正文。
6、title：完整文章標題。

錯誤處理與重試¶

官方規定了兩層判斷邏輯。

先看輸出內容：

1、如果輸出包含 Invalid authorization，說明 API Key 無效或已過期。此時不要重試，引導用戶重新檢查並提供正確的 Key。
2、如果輸出不含 Invalid authorization，但任務失敗（例如輸出以 Error: 開頭，或返回空結果），自動再執行一次腳本。

重試上限爲一次。第二次仍失敗就停止重試，把具體錯誤信息回報給用戶。

適用場景¶

官方列出的典型場景包括：

1、內容監測：追蹤公衆號文章中對特定品牌或話題的提及。
2、媒體研究：分析頭部公衆號發佈文章的全文。
3、趨勢跟蹤：收集某個上升行業話題（如 AI agent）的相關文章做系統閱讀。
4、知識庫建設：把深度長文提取進內部資料庫。
5、競品分析：查看競品賬號發佈的完整文章。

注意與限制¶

以下幾點需要留意。

需要 API Key：標籤爲 requires_api_key=true，沒有配置 BROWSERACT_API_KEY 就無法運行，且申請需要用戶自己去 BrowserAct Console 完成。

運行時間不短：屬於瀏覽器自動化任務，官方明確提示可能耗時數分鐘，批量採集時應把等待和輪詢預期調好。

關鍵詞決定召回質量：這個 Skill 做的是「按關鍵詞搜索再提取」，召回範圍受微信搜索本身覆蓋的賬號和排序影響，不是全量訂閱號抓取。

價格未在資料中給出：是否計費、按量還是按任務，需要到 BrowserAct Console 查看。

該技能在官方簡介中還提到，如需新媒體內容研究的完整工作流套件，可在淘寶搜索「AI靈匣」店鋪獲取完整版。這條信息來自技能自身的描述，本文僅作轉述。

小結¶

wechat-article-search-api-skill 的價值在於把「搜索公衆號 + 提取正文 + 結構化字段」壓縮成一條命令，省去自建採集要面對的驗證碼、IP 限制和正文解析成本。適合有批量公衆號文章採集需求、且願意配置 BrowserAct API Key 的開發者。