PublicWWW

PublicWWW MCP サーバー

AI アシスタントから、数億件のウェブサイトのソースコード（HTML、JavaScript、CSS）を検索できます。特定のスクリプトを読み込むサイト、ライブラリを使用するサイト、トラッキング ID やウィジェットを設置しているサイトを調べ、それらをクラスターとして保存し、ページから連絡先、ソーシャルプロフィール、タグ ID を抽出できます。PublicWWW はリモート MCP サーバーを提供しています。

https://api.publicwww.com/mcp

ツールは 10 個あります。search（クエリ、行数、ページ、スニペット）、account（プラン、今日の検索残数と抽出ポイント残数）、read_docs（PublicWWW 独自のドキュメントと料金表を Markdown で取得）、およびクラスター用の 7 個です。同じドキュメントページは MCP リソース publicwww://docs/<page> としても利用できます。ツールの利用には有料プランが必要です。無料アカウントでも接続してドキュメントを読めます。詳しくは利用制限をご覧ください。

サインイン

• OAuth - Claude、ChatGPT、Claude Code では、PublicWWW のページに移動して「許可」を押します。 コピーするものはありません。
• トークン - その他のクライアントでは、Authorization: Bearer <token> を送信します。 プロフィールページでトークンを発行し、 PUBLICWWW_TOKEN 環境変数に保存してください。

インストール

クライアント	方法
Claude（ウェブ、デスクトップ）	Customize → Connectors → Add custom connector で、上記の URL を入力します - ガイド
ChatGPT	Plugins → Add → Add custom MCP server を選び、OAuth で接続します - ガイド
Claude Code	下記のプラグインを使うか、claude mcp add --transport http publicwww https://api.publicwww.com/mcp を実行します
Cursor
VS Code
Gemini CLI	gemini extensions install https://github.com/publicwww-com/publicwww-mcp
Codex CLI	codex mcp add publicwww --url https://api.publicwww.com/mcp --bearer-token-env-var PUBLICWWW_TOKEN
その他	clients/ にある設定ファイルを使用します

Cursor ボタンは PUBLICWWW_TOKEN からトークンを読み込みます。VS Code ではトークンを一度入力すると、シークレットストレージに保存されます。

Claude Code プラグイン

MCP サーバー（OAuth でサインイン）と、クエリ構文を説明するスキルをインストールします。

/plugin marketplace add publicwww-com/publicwww-mcp
/plugin install publicwww@publicwww

次に /mcp を実行し、publicwww を選んで「Authenticate」を選択します。

Gemini CLI 拡張機能

gemini extensions install https://github.com/publicwww-com/publicwww-mcp

トークンを一度入力すると、システムのキーチェーンに保存されます。

エージェントスキル

skills/publicwww-search は、オープンな Agent Skills 形式のスキルです。PublicWWW のクエリの書き方とツールの使い方を説明しています。フォルダーをエージェントのスキルディレクトリ（例：.agents/skills/ または ~/.claude/skills/）にコピーしてください。

クエリ構文の概要

クエリ	検索対象
"angular.min.js"	ページのソースに含まれる、その完全一致のテキスト
bootstrap jquery	ページ内のどこかに両方含まれるもの
jquery (slick | swiper)	jquery と、slick または swiper のいずれか
"amcharts.js" -bootstrap	1 つ目を含み、2 つ目を含まないもの
site:de bootstrap	.de サイトのみ
depth:all "math.min.js"	ホームページだけでなく、内部ページも

詳細はクエリ構文をご覧ください。

クラスター

クラスターとは、アシスタントがデータの構築、結合、抽出に使用できる、保存済みのウェブサイト一覧です。

ツール	機能
list_clusters	アカウントのクラスターを新しい順に一覧表示します
get_cluster	クラスター内のドメインをページ単位で取得します
create_cluster	検索（query、検索を1回消費）またはdomainsの一覧から作成します
combine_clusters	クラスターのand、or、またはdiff（1つ目に含まれ、2つ目には含まれないもの）を取得します
extract_from_cluster	各サイトのページソースから値を取得します。既定のpresetsまたは独自のregexを使用し、部分ごとに抽出します
rename_cluster	新しい名前に変更します
delete_cluster	完全に削除します。破壊的な操作としてマークされているため、アシスタントが先に確認します

プリセット：email、phone、whatsapp、telegram、viber、line、facebook、 instagram、x、linkedin、youtube、tiktok、pinterest、threads、bluesky、 discord、github、google_play、app_store。それ以外は、最初のグループが値となるスラッシュで囲んだ正規表現です。例： /data-site-id="([0-9]+)"/i。抽出にはその日の抽出ポイントを消費します。1つのアカウントで保持できるクラスターは最大100個です。

自然な言葉で、たとえば次のように依頼できます：「static.hotjar.comを読み込むサイトを見つけて、クラスターとして保存し、連絡先のメールアドレスと電話番号を取得して」。アシスタントはcreate_clusterを実行し、クラスターの処理が完了するまで、emailとphoneのプリセットを使ってextract_from_clusterを実行します。詳しくはツールをご覧ください。

直接呼び出す

examples/mcp-curl.shでは、ツールの一覧表示、アカウント情報の読み取り、プレーンなcurlを使った検索を行います。Streamable HTTP、JSON形式の応答、セッションなしです。詳しくは開発者向け情報をご覧ください。

スクリプトにはREST APIのほうが簡単です。同じ検索、クラスター、トークンをCSVおよびNDJSONで利用できます。小規模なクライアント： Python、 JavaScript、 PHP、 Go、 Ruby。

ドキュメント

publicwww.com/docs/mcp

ライセンス

MIT