English Français العربية

PublicWWW

Official registry Developer tools

Search the source code (HTML, JavaScript, CSS) of hundreds of millions of websites.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http publicwww 'https://api.publicwww.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "publicwww": {
            "type": "http",
            "url": "https://api.publicwww.com/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PublicWWW MCP server
  2. Sign in
  3. Install
  4. Query syntax, briefly
  5. Clusters
  6. Calling it directly
  7. Documentation
  8. License

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

ClientHow
Claude (web, desktop)Customize → Connectors → Add custom connector, URL above - guide
ChatGPTPlugins → Add → Add custom MCP server, OAuth - guide
Claude Codethe plugin below, or claude mcp add --transport http publicwww https://api.publicwww.com/mcp
Cursor
VS Code
Gemini CLIgemini extensions install https://github.com/publicwww-com/publicwww-mcp
Codex CLIcodex mcp add publicwww --url https://api.publicwww.com/mcp --bearer-token-env-var PUBLICWWW_TOKEN
Anything elsea 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

QueryFinds
"angular.min.js"that exact text in the page source
bootstrap jqueryboth, anywhere on the page
`jquery (slick \swiper)`jquery and either of the two
"amcharts.js" -bootstrapthe first without the second
site:de bootstraponly .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.

ToolWhat it does
list_clustersthe account's clusters, newest first
get_clustera page of the domains in a cluster
create_clusterfrom a search (query, costs one search) or a list of domains
combine_clustersand, or, or diff (in the first, not in the second) of clusters
extract_from_clustervalues from the page source of every site: ready-made presets or your own regex, part after part
rename_clustera new name
delete_clusterdeletes 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

Frequently asked questions

What is PublicWWW?

Search the source code (HTML, JavaScript, CSS) of hundreds of millions of websites.

How do I install PublicWWW?

It runs as a remote server. In Claude Code: claude mcp add --transport http publicwww 'https://api.publicwww.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does PublicWWW need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is PublicWWW open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains PublicWWW?

It is published by publicwww-com. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.