PublicWWW

com.publicwwwv1.0.1Updated Oct 8, 2026

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

VerifiedStreamable HTTPWeb executableDeveloper Tools Web Search & Scraping

Overview

AI-generated overview

Lets an assistant search the page source code of hundreds of millions of websites for scripts, libraries, tracking IDs, and widgets.

What it does: PublicWWW exposes a remote MCP server with two read-only tools: search, which queries the HTML, JavaScript, and CSS source of indexed websites, and account, which reports the current plan and searches left today. Queries support exact text, multiple terms, alternatives, exclusions, site: filters, and depth:all for inner pages. Results can include rows, paging, and snippets.
When to use it: Useful when you want to find which sites load a particular script, use a library, or carry a tracking ID or widget, and to check remaining search quota before running more queries.
Requirements: A remote streamable HTTP endpoint at Sign-in is by OAuth for Claude, ChatGPT, and Claude Code, or by a bearer token issued on the PublicWWW profile page and supplied through the PUBLICWWW_TOKEN environment variable for other clients. A PublicWWW account is needed; a free account works within its limits.

Before you install

The bearer token is a credential: keep it in PUBLICWWW_TOKEN and avoid exposing it in shared configs or logs. The tools are read-only and do not modify data, but searches are sent to PublicWWW's service and consume account quota.

Installation

In SourceWeft

Open PublicWWW in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "publicwww": {
      "type": "http",
      "url": "https://api.publicwww.com/mcp"
    }
  }
}

README

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. PublicWWW runs a remote MCP server:

Two read-only tools: search (query, rows, page, snippets) and account (plan and searches left today). Every account can use it, a free one included - 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	[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`
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:

Then run /mcp, pick publicwww and choose Authenticate.

Gemini CLI extension

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 two 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.

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 and token, with CSV and NDJSON. Small clients: Python, JavaScript, PHP, Go, Ruby.

Documentation

publicwww.com/docs/mcp

License

MIT

Source: README.md at commit b3c5b8e

Tools

Tool metadata has not been indexed yet.

Version history

v1.0.1LatestOct 8, 2026