Worldbook CLI
"Human uses GUI, We uses CLI."
CLI tool for AI agents to access world knowledge.
Install
# PyPI
pip install worldbook
# npm (global install)
npm i -g worldbook
Usage
# Show manifesto
worldbook manifesto
# Check status
worldbook status
worldbook --json status
# Search worldbooks
worldbook query github
worldbook --json query github
# Get a worldbook
worldbook get github
worldbook --json get github
# Discover browser-page WebMCP tools for a URL
worldbook webmcp get "https://www.google.com/search?q=worldbook"
worldbook --json webmcp get "https://www.google.com/search?q=worldbook"
# Print agent setup instructions for Claude Code, Codex, or other agents
worldbook webmcp instructions
# Point to a local server
export WORLDBOOK_BASE_URL=http://localhost:8000
worldbook query github
WebMCP for Third-Party Agents
WebMCP lets an agent discover browser-page tools from the current URL without installing mcp-chrome.
worldbook --json webmcp get "<current-page-url>"
The command calls the existing Worldbook endpoint:
GET /api/webmcp/match?url=<current-page-url>
If a site matches, the response includes tools. Each tool has:
namedescriptioninputSchemahandler
The handler is JavaScript function source. A third-party agent should execute handler(params) in the matched browser page context using its own browser automation runtime, then return the JSON-serializable result.
For Claude Code, Codex, or any other agent with custom instructions, use:
worldbook webmcp instructions
The Dual Protocol Manifesto
We believe in a web that serves all intelligence.
GO AWAY SKILLS. GO AWAY MCP. WE LIKE CLI.
- Skills? → Vendor lock-in, complex schemas, approval queues
- MCP? → Protocol overhead, server setup, configuration hell
- CLI? → Just works. stdin/stdout. Every agent understands.
A worldbook is just a text file that tells us how to use your service. No SDK. No protocol. No ceremony. Just instructions.
License
MIT
Metadata
Release files for worldbook 0.1.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| worldbook-0.1.11.tar.gz | 5.2 kB | Without provenance | Details for worldbook-0.1.11.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| worldbook-0.1.11-py3-none-any.whl | Python 3 | none | any | Details for worldbook-0.1.11-py3-none-any.whl |
Total release size: 11.2 kB
Release files / worldbook-0.1.11.tar.gz
| Download URL | worldbook-0.1.11.tar.gz |
|---|---|
| Size | 5.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
04fc387c112e21df7a19207e99c77028d35151d19d72e2c82f6987022cd847ae
|
|
BLAKE2b-256 checksum How to use checksums |
b35053e82c10a54f67adf59509c7525f804d7726066a71c18aef06b2076db587
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.4
|
Release files / worldbook-0.1.11-py3-none-any.whl
| Download URL | worldbook-0.1.11-py3-none-any.whl |
|---|---|
| Size | 5.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
38cc64dd4beb516c11e6ee7f063f07356e28990e97d0324cdd60fe927446e344
|
|
BLAKE2b-256 checksum How to use checksums |
93238c66c2581a37154913d84447fa0ffce6ecfd722f8f9f67f0460ef25cf24d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.4
|
Security for worldbook 0.1.11
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.