google-news-api-skill

Google News 自動化スキル

📖 はじめに

このスキルは、BrowserAct の Google News API テンプレートを使用したワンストップのニュース収集サービスを提供します。Google News から、見出し、情報源、公開日時、記事リンクなどの構造化されたニュース結果を直接抽出します。検索キーワードと期間フィルターを入力するだけで、すぐに利用できる整ったニュースデータを取得できます。

✨ 特長

1. ハルシネーションなし：あらかじめ設定されたワークフローにより、AI 生成によるハルシネーションを防ぎ、安定した正確なデータ抽出を実現します。
2. CAPTCHA の問題なし：reCAPTCHA やその他の認証チャレンジに対処する必要はありません。
3. IP 制限なし：地域 IP 制限やジオフェンシングに対処する必要はありません。
4. 高速な実行：AI 駆動のみのブラウザー自動化ソリューションと比べて、タスクをより高速に実行できます。
5. 低コスト：大量のトークンを消費する AI ソリューションと比べて、データ取得コストを大幅に削減できます。

🔑 API キーの設定

実行前に、BROWSERACT_API_KEY 環境変数を確認してください。設定されていない場合は、ほかの対応をせず、ユーザーに確認して提供を待ってください。 エージェントはユーザーに次のように伝えてください：

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

🛠️ 入力パラメーター

エージェントは、ユーザーのニーズに応じて以下のパラメーターを柔軟に設定してください。

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

   • 型：string
   • 説明：Google News で検索する内容です。企業名、業界用語、競合他社名などを指定できます。
   • 例：AI Startup、Tesla、SpaceX

2. Publish_date（期間）

   • 型：string
   • 説明：公開日時でニュースを絞り込みます。
   • 選択肢：
     • any time：制限なし
     • past hours：過去数時間（速報ニュース）
     • past 24 hours：過去 24 時間（日次モニタリング）
     • past week：過去 1 週間（短期的なトレンド）
     • past year：過去 1 年（長期的な調査）
   • デフォルト：past week

3. Datelimit（最大件数）

   • 型：number
   • 説明：タスクごとに抽出するニュース項目の最大数です。
   • デフォルト：30
   • 推奨：リアルタイムのモニタリングには 10～30 件を使用し、詳細な調査にはより大きな値を使用してください。

🚀 使い方

エージェントは、以下の独立したスクリプトを使用して「ワンライナーでの結果出力」を実現してください。

# Example
python -u ./scripts/google_news_api.py "Search Keywords" "Publish Date" Quantity

⏳ 実行状況のモニタリング

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

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

📊 データ出力

実行が成功すると、スクリプトは API レスポンスから結果を解析して直接出力します。結果には以下が含まれます：

• headline：ニュースの見出し
• source：発行元／情報源
• news_link：記事 URL
• published_time：公開日時
• author：著者（取得可能な場合）

⚠️ エラー処理と再試行

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

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

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

2. 再試行の上限：

   • 自動再試行は1回までです。2回目の試行も失敗した場合は、再試行を停止し、具体的なエラー情報をユーザーに報告してください。

🌟 典型的な使用例

1. 業界トレンドの追跡：「低空経済」や「生成 AI」などの分野における最新の動向を探します。
2. PR モニタリング：特定のブランドや企業の過去24時間のメディア露出を監視します。
3. 競合情報の収集：過去1週間に競合他社が発表した新製品やマーケティング活動の情報を収集します。
4. 市場調査：さまざまな時間軸で、特定のキーワードに関する人気レポートを取得します。
5. 人物の動向追跡：業界のリーダーや著名人に関する最新のニュース報道を取得します。
6. 毎日のニュース要約：特定の分野の日々のニュースを自動的に抽出して要約します。
7. 世界の速報ニュース：世界の主要な出来事に関する最新情報をリアルタイムで取得します。
8. 構造化データの抽出：分析用に、見出し、情報源、リンクなどの構造化された情報を抽出します。
9. メディア露出の分析：主要なニュースメディアにおけるプロジェクトやイベントの拡散度を評価します。
10. 長期的な調査：特定の技術トピックに関する過去1年間の詳細なレポートをすべて取得します。