How do I install PublicWWW?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does PublicWWW need an API key?

No required environment variable is listed on this record.

What transport does PublicWWW use?

PublicWWW is reached over HTTP.

When was PublicWWW last checked?

Last checked 2026-11-11. Search the source code (HTML, JavaScript, CSS) of web pages.

PublicWWW MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.publicwww.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.publicwww-publicwww https://api.publicwww.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.publicwww-publicwww": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.publicwww.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.3.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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