wechat-article-search-api-skill

WeChat 記事検索 API

📖 概要

このスキルでは、BrowserAct WeChat Article Search API テンプレートを通じて、WeChat 記事を自動抽出できます。キーワード検索に基づいて、構造化された記事全文を直接抽出できます。検索キーワードと必要に応じて日付フィルターを指定するだけで、本文全体を含む包括的な記事データを取得できます。

✨ 特長

1. ハルシネーションがなく、安定して正確なデータ抽出を実現：事前設定済みのワークフローにより、AI が生成するハルシネーションを回避します。
2. CAPTCHA の問題なし：reCAPTCHA やその他の認証チャレンジに対応する必要はありません。
3. IP 制限や地域ブロックなし：地域ごとの IP 制限に対応する必要はありません。
4. 高速な実行：AI 主導のブラウザー自動化ソリューションのみを利用する場合と比べて、タスクをより速く実行できます。
5. 非常に高いコストパフォーマンス：大量のトークンを消費する AI ソリューションと比べて、データ取得コストを大幅に削減します。

🔑 API キーの確認フロー

実行前に、BROWSERACT_API_KEY 環境変数を確認してください。設定されていない場合は、ほかの操作を行わず、ユーザーにキーの提供を依頼して待機してください。 エージェントはユーザーに次のように伝える必要があります：

「BrowserAct API Key が設定されていません。BrowserAct Console にアクセスしてキーを取得してください。」

🛠️ 入力パラメーター

スクリプトを呼び出す際、エージェントはユーザーのニーズに応じて次のパラメーターを柔軟に設定してください。

1. keywords（検索キーワード）

   • 型：string
   • 説明：WeChat 記事の検索に使用するキーワードです。業界用語、トピック、具体的なフレーズを指定できます。
   • 例：openclaw、AI agent、browser automation

2. Date_limit（抽出件数上限）

   • 型：number
   • 説明：抽出する記事の最大件数です。初回実行時は、より小さい値をデフォルトとして指定することをおすすめします。
   • デフォルト値：10
   • 推奨値：簡単なテストには 5～10 を、まとめて調査する場合はより大きな値を使用してください。

3. publication_date（公開日のフィルター）

   • 型：string
   • 説明：記事を公開日で絞り込みます。
   • 例：3月11日、March 10、2026-03-11

🚀 呼び出し方法

「1つのコマンドで結果を直接取得」するため、エージェントは次の独立したスクリプトを実行してください。

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

⏳ 実行状況の監視

このタスクにはブラウザーの自動操作が含まれるため、完了までに長時間（数分）かかることがあります。実行中、スクリプトはタイムスタンプ付きの状況ログを継続的に出力します（例：[14:30:05] Task Status: running）。 エージェントへの指示：

• スクリプトから結果が返るまで、ターミナルの出力を監視し続けてください。
• ターミナルに新しい状況ログが出力され続けている限り、タスクは正常に実行中です。デッドロックや応答停止と誤認しないでください。
• 状況が長時間変わらない場合、または結果が返らないままスクリプトの出力が止まった場合に限り、再試行の仕組みを起動することを検討してください。

📊 出力データの説明

実行が成功すると、スクリプトは API のレスポンスから結果を解析し、そのまま出力します。結果には次の情報が含まれます。

• url_link：元の記事の URL
• publication_date：記事の公開日
• author：記事の著者または配信アカウント名
• image_url：メイン画像または記事カバー画像の URL
• body_content：記事本文全体
• title：記事のタイトル全文

⚠️ エラー処理と再試行

スクリプトの実行中にエラー（ネットワークの不安定さやタスクの失敗など）が発生した場合、エージェントは次の手順に従います。

1. 出力内容を確認する：

   • 出力に"Invalid authorization"が含まれる場合、API Keyが無効または期限切れであることを意味します。この場合、再試行せず、正しいAPI Keyを確認して入力するようユーザーに案内します。
   • 出力に"Invalid authorization"が含まれないにもかかわらずタスクが失敗した場合（出力がError:で始まる、または空の結果が返されるなど）、エージェントはスクリプトを自動的にもう一度実行します。

2. 再試行の上限：

   • 自動再試行は1回のみです。2回目も失敗した場合は再試行を中止し、具体的なエラーメッセージをユーザーに報告します。

🌟 代表的なユースケース

1. コンテンツのモニタリング：WeChatの記事全体を対象に、特定のブランドやトピックへの言及を追跡します。
2. メディア調査：人気のWeChatアカウントが公開した記事の全文を分析します。
3. トレンドの追跡：包括的なリーディングのために、注目を集めている業界トレンド（AIエージェントなど）に関する記事を収集します。
4. ナレッジベースの構築：詳細な解説記事を社内リポジトリに抽出します。
5. 競合分析：競合アカウントが公開した長文投稿を確認します。