PublicWWW

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

Ten 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 seven for clusters. The same documentation pages are MCP resources, publicwww://docs/<page>. The tools need a paid plan; a free account can connect and read the documentation - 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 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