PublicWWW MCP server
Search the source code (HTML, JavaScript, CSS) of hundreds of millions of websites
from an AI assistant: which sites load a script, use a library, carry a tracking id
or a widget. PublicWWW runs a remote MCP server:
https://api.publicwww.com/mcp
Two read-only tools: search (query, rows, page, snippets) and account (plan and
searches left today). Every account can use it, a free one included - see
limits.
Sign in
- OAuth - Claude, ChatGPT and Claude Code send you to PublicWWW to press Allow.
Nothing to copy.
- A token - other clients send
Authorization: Bearer <token>. Issue one on your
profile page and keep it in the
PUBLICWWW_TOKEN environment variable.
Install
| Client | How |
|---|
| Claude (web, desktop) | Customize → Connectors → Add custom connector, URL above - guide |
| ChatGPT | Plugins → Add → Add custom MCP server, OAuth - guide |
| Claude Code | the plugin below, or 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 |
| Anything else | a config file from clients/ |
The Cursor button reads the token from PUBLICWWW_TOKEN; VS Code asks for it once
and keeps it in its secret storage.
Claude Code plugin
The MCP server (sign in with OAuth) and a skill that teaches the query syntax:
/plugin marketplace add publicwww-com/publicwww-mcp
/plugin install publicwww@publicwww
Then run /mcp, pick publicwww and choose Authenticate.
Gemini CLI extension
gemini extensions install https://github.com/publicwww-com/publicwww-mcp
It asks for the token once and keeps it in the system keychain.
Agent skill
skills/publicwww-search is a skill in the open
Agent Skills format: how to write PublicWWW queries and use the two tools. Copy the
folder into your agent's skills directory (for example .agents/skills/ or
~/.claude/skills/).
Query syntax, briefly
| Query | Finds |
|---|
"angular.min.js" | that exact text in the page source |
bootstrap jquery | both, anywhere on the page |
jquery (slick | swiper) | jquery and either of the two |
"amcharts.js" -bootstrap | the first without the second |
site:de bootstrap | only .de sites |
depth:all "math.min.js" | inner pages too, not only home pages |
More: query syntax.
Calling it directly
examples/mcp-curl.sh lists the tools, reads the account and
runs a search with plain curl. Streamable HTTP, JSON answers, no sessions - see
for developers.
For scripts the REST API is the simpler road - the
same search and token, with CSV and NDJSON. Small clients:
Python,
JavaScript,
PHP,
Go,
Ruby.
Documentation
publicwww.com/docs/mcp
License
MIT