AgentWebSearch

AI エージェント向けの、API を必要としない公開 Web 検索および本文読み取りツールです。

機能

検索 API Key なしで公開 Web を検索します。
公開 URL から記事タイトルと本文を読み取ります。
まず Python の直接 HTTP リクエストを使用し、ブラウザ描画が必要な場合のみ、新しいプライベート Playwright Chromium プロセスを起動します。
offset と exclude_urls によるバッチ検索をサポートし、後続バッチで既出 URL を除外します。
CAPTCHA、ログイン壁、有料壁、到達不能ページ、非 HTML ページは正直に失敗として返します。検証を回避したり、本文を捏造したりしません。
ユーザーに見えるブラウザを開いたり操作したりせず、Cookie、検索履歴、API Key、ブラウザプロファイルを保存しません。

ツール

ツール	用途
`agent_web_search`	タイトル、URL、要約、検索エンジン、バッチ offset、エンジン状態を返します。
`agent_web_read`	1 回につき最大 10 個の公開 URL からタイトルと読み取り可能な本文を抽出します。

バッチ検索の例：

1 バッチ目: offset=0,  limit=10
2 バッチ目: offset=10, limit=10, exclude_urls=<1 バッチ目の URL>
3 バッチ目: offset=20, limit=10, exclude_urls=<最初の 2 バッチの URL>

要求数は上限であり、保証ではありません。公開検索ページは新しい結果を少数しか返さない場合や、人による検証を要求する場合があります。

バックエンド

direct：Python requests。API Key は不要です。
headless_browser：一時的な Playwright Chromium。画面を表示せず、ユーザーブラウザを操作しません。
auto：まず直接接続を試し、失敗または新規結果がない場合だけヘッドレスブラウザへ切り替えます。

Hermes Agent

hermes plugins install FirmaSpring/AgentWebSearch --enable

任意のブラウザバックエンド：

pip install 'playwright>=1.45'
playwright install chromium

MCP Server

MCP は同じ API 不要の Python 検索・読み取りコアを再利用します。MCP はローカルツールプロトコルであり、検索 API や API Key は必要ありません。

uv sync --extra mcp --extra browser --group dev
playwright install chromium
.venv/Scripts/agent-web-search-mcp.exe

Windows MCP クライアント設定例：

{
  "mcpServers": {
    "agent-web-search": {
      "command": "C:\\path\\to\\AgentWebSearch\\.venv\\Scripts\\agent-web-search-mcp.exe",
      "args": []
    }
  }
}

stdio Server は web_search と web_read を公開し、ネットワークポートを待ち受けず、MCP セッション状態を保存せず、クライアント終了時に停止します。

他エージェントへの対応

MCP Python SDK 2.x の stdio クライアントで、初期化、ツール検出、web_search、web_read の実 MCP メッセージ試験を完了しています。

接続方法	状態	備考
Hermes Agent ネイティブプラグイン	利用可能	このリポジトリに含まれます。
汎用 stdio MCP クライアント	プロトコル検証済み	`web_search` と `web_read` を利用できます。
OpenCode / VS Code / Gemini CLI	MCP 対応	公式ドキュメントは MCP Server をサポートします。ホストごとの設定検証は別途必要です。
OpenClaw / Claude Code / Codex / Cursor / Cline / Continue	MCP 候補ホスト	現行版が stdio MCP をサポートする場合のみ設定し、各ホストを実測後に「検証済み」とします。

プライバシー

検索語は選択した公開検索エンジンへ送信されます。URL 読み取りでは対象 URL にリクエストを送信します。このプラグイン自体に API Key は不要です。

開発

python -m pytest -q

ライセンス

MIT

FilesExpand file tree

README.ja.md

Latest commit

History