PublicWWW
Search the source code (HTML, JavaScript, CSS) of hundreds of millions of websites.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http publicwww 'https://api.publicwww.com/mcp'{
"mcpServers": {
"publicwww": {
"type": "http",
"url": "https://api.publicwww.com/mcp"
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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/mcpTen 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 thePUBLICWWW_TOKENenvironment 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@publicwwwThen run /mcp, pick publicwww and choose Authenticate.
Gemini CLI extension
gemini extensions install https://github.com/publicwww-com/publicwww-mcpIt 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
License
MIT
Questions fréquentes
Qu'est-ce que PublicWWW ?
Search the source code (HTML, JavaScript, CSS) of hundreds of millions of websites.
Comment installer PublicWWW ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http publicwww 'https://api.publicwww.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour PublicWWW ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
PublicWWW est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient PublicWWW ?
Il est publié par publicwww-com. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.