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 - then save them as a cluster and pull contacts, social profiles or tag
ids out of their pages. PublicWWW runs a remote MCP server:

https://api.publicwww.com/mcp

Eleven tools: search (query, rows, page, snippets), account (plan, searches and
extraction points left today), read_docs (PublicWWW's own documentation and price
list in Markdown) and eight for clusters. The same documentation pages
are MCP resources, publicwww://docs/<page>. Without signing in, the tool list and
read_docs work; the other tools need a paid plan, and a free account gets
plan_required from them - 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`
opencode	`clients/opencode.json`
Goose	`clients/goose.config.yaml`
DeepSeek Harness	`dsh plugin --profile <your profile> add github:publicwww-com/dsh-publicwww` - plugin
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 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.

Clusters

A cluster is a saved list of websites the assistant can build, combine and extract
data from.

Tool	What it does
`list_clusters`	the account's clusters, newest first
`get_cluster`	a page of the domains in a cluster
`create_cluster`	from a search (`query`, costs one search) or a list of `domains`
`combine_clusters`	`and`, `or`, or `diff` (in the first, not in the second) of clusters
`extract_from_cluster`	values from the page source of every site: ready-made `presets` or your own `regex`, part after part
`rename_cluster`	a new name
`delete_cluster`	deletes for good; marked destructive, so the assistant asks you first

Presets: email, phone, whatsapp, telegram, viber, line, facebook,
instagram, x, linkedin, youtube, tiktok, pinterest, threads, bluesky,
discord, github, google_play, app_store. Anything else
is a regular expression in slashes whose first group is the value, e.g.
/data-site-id="([0-9]+)"/i. Extraction spends the day's extraction points; an
account keeps up to 100 clusters.

Ask in plain words: "Find sites that load static.hotjar.com, save them as a cluster
and get their contact emails and phones" - the assistant runs create_cluster,
then extract_from_cluster with the email and phone presets until the cluster
is done. More: tools.

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, clusters and token, with CSV and NDJSON. Small clients:
Python,
JavaScript,
PHP,
Go,
Ruby.

Documentation

publicwww.com/docs/mcp

License

MIT