Skip to main content
Glama
PublicWWW MCP server

PublicWWW MCP server

Official

PublicWWW MCP server

Search the source code (HTML, JavaScript, CSS) of web pages 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

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.

Related MCP server: Prospect Research MCP Server

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

Install MCP Server

VS Code

Install in 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

Qwen Code

clients/qwen.settings.json

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/).

skills/publicwww-api does the same for the REST API, for agents that call it from code or the shell.

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

Related MCP Connectors

Related MCP Servers