pomerado README

项目的 README,来自 github.com/Pomerado/pomerado。合并为一个 markdown 文件:README.md。

Pomerado

Turn websites into MCP integrations your agent can rely on.

License MIT npm version Node 24.21 or later in Node 24

How it works · Get started · Create an integration · Use your integration · Open source and Cloud · Docs · Discord · Contributing


What Pomerado does

Pomerado builds MCP integrations for websites, including sites without an API.

How it works

┌──────────────────────────────────────────────────────────────────────────┐
│  explore the site → complete your example → generalize → agent calls it  │
└──────────────────────────────────────────────────────────────────────────┘

For more details, see How it works.

Get started

Prerequisites

Install Pomerado and the Chromium build it drives.

npx -y -p pomerado pomerado-mcp --help
npx -y -p pomerado playwright install chromium

On Linux, add --with-deps after install if Chromium's system libraries are missing.

Pomerado runs as a standard MCP stdio server. Clients that read an mcpServers file use this entry.

{
  "mcpServers": {
    "pomerado": {
      "command": "npx",
      "args": ["-y", "-p", "pomerado", "pomerado-mcp", "mint", "--root", "/absolute/path/to/pomerado-integrations"]
    }
  }
}

Add Pomerado to your client with the command or file below.

Client Add Pomerado
Claude Code claude mcp add --scope user pomerado -- npx -y -p pomerado pomerado-mcp mint --root ~/pomerado-integrations
Codex codex mcp add pomerado -- npx -y -p pomerado pomerado-mcp mint --root ~/pomerado-integrations, then add env_vars
Gemini CLI gemini mcp add -s user -e 'OPENAI_API_KEY=$OPENAI_API_KEY' pomerado npx -y -p pomerado pomerado-mcp mint --root ~/pomerado-integrations
Cursor Add the entry to ~/.cursor/mcp.json
VS Code code --add-mcp '{"name":"pomerado","command":"npx","args":["-y","-p","pomerado","pomerado-mcp","mint","--root","/absolute/path/to/pomerado-integrations"]}', or add the entry to .mcp.json in your workspace
Claude Desktop Add the entry to claude_desktop_config.json

Each client passes environment variables its own way. Client settings covers the key and the timeouts for every client above.

To confirm the setup, ask your agent which Pomerado tools it has. It should list mint, get_job, provide_input and cancel_job.

Let your agent set it up

If you'd rather not run these steps yourself, paste this into your agent.

Set up Pomerado for me by following https://raw.githubusercontent.com/Pomerado/pomerado/main/docs/agent-setup.md

Your agent checks your Node version, installs Chromium and adds Pomerado to the client it runs in. It asks before changing anything you didn't mention, and it never asks for your API key in chat.

Create an integration

Ask your agent to create an integration with Pomerado. We call this minting. A good request names the site, describes the task in plain language and says whether the integration should only read or also make changes.

Use Pomerado to create an integration named example_reader that reads the main heading from https://example.com. Keep it read-only.

Your agent runs the mint with four tools.

Authority decides what an integration is allowed to do, so choose it deliberately. Your agent picks one when it calls mint, and the tool tells it to ask you before choosing write.

Pomerado types your login only on the site, or on a sign-in address you pass in authenticationOrigins when you call mint. A sign-in form whose fields or submit go to any other website is refused before anything is typed. A sign-in whose pages are on another website doesn't publish, even one you pass there. Pomerado doesn't ask about other addresses, and it doesn't check where the page's own scripts send what you typed.

Names start with a lowercase letter and use only lowercase letters, digits and underscores. The integration's folder must not exist yet. Each mint gets 20 minutes of active work, and time spent waiting for your answers doesn't count against it.

Use your integration

When minting finishes, Pomerado saves the integration as a folder of source code and returns its paths.

pomerado-integrations/example_reader/
├── src/                 Generated operation modules
├── pomerado.json        Entrypoint, input and output schemas, and the questions a run may ask
├── auth-fill.json       Sign-in screens a build that signed in recorded, with no value
├── deployment.json      Tool name, description, URL, task, authority and sign-in origins
├── mcp.mjs              Launcher for the shared Pomerado runtime
├── mcp.json             Standard MCP server entry, with no key
└── README.md            Add commands for each MCP client
  1. Open the integration's README.md. It has the add command for each major client with your paths already filled in
  2. Add the server with that command. Skip the key setup. Running an integration makes no model request, so only minting needs OPENAI_API_KEY
  3. Reload your client and ask your agent to use the integration

Use example_reader to read the page heading.

Each integration appears to your agent as its own MCP server.

Open source and Pomerado Cloud

This repository is the complete Pomerado core, released under the MIT license. Everything you need to mint integrations and run them yourself is here, with no Pomerado account required.

Pomerado Cloud runs this same core as a managed service. It adds the operations that production use needs.

Documentation for humans and agents

Repository guide

Path Contents
typescript/src/ Minter, Guardian, runtime, browser helpers and the local MCP host
typescript/authoring/ Shared prompts and examples, with sections a host can replace
typescript/tests/ Unit tests and browser tests with local fixture sites
tools/ Build helpers, the CI scans and the browser shard planner
docs/ Guides for users, agents and maintainers
third-party/ Licenses for adapted third-party code

How it works lists each module under typescript/src/.

Community

Join the Pomerado Discord to get help, share integrations you build, and discuss contributions.

Contributing

License

Copyright (c) 2026 Pomerado AI, Inc. Licensed under the MIT License (MIT). See LICENSE.

Versions 0.1.2 and earlier were published under the GNU Affero General Public License version 3 only (AGPL-3.0-only).

Third-party code keeps its own license. The Guardian policy in typescript/src/guardian/upstream-policy.md is adapted from OpenAI Codex under the Apache License 2.0. Its license and notice are in third-party/codex/ and ship with the npm package. The accessible name computation in typescript/src/destinations/accessible-name.ts is adapted from Playwright under the Apache License 2.0. Its license and notice are in third-party/playwright/ and ship with the npm package.

Star History

Star History Chart

pomerado (Pomerado/pomerado)

正在搜索数据库…

这是什么?Pomerado 能把任何网站(包括没有 API、或需要登录和两步验证的网站)转换为确定性的 MCP 集成,你的 AI 代理可以把它当作工具来调用。你只需用日常语言描述任务即可,无需提供录制好的 HAR 文件。
这是我自己运行的开源工具,还是托管服务?本仓库是完整的开源 MIT 核心版本:包含一个驱动真实 Chromium 浏览器的铸造器、一个 Guardian 审查器和一个本地 MCP 主机,全部在你自己的机器上运行,无需注册账号。Pomerado Cloud 是同一核心的付费托管版本,额外提供托管、OAuth 和机器人防护处理。
我该如何让它运行起来?安装并将其注册为你的客户端的本地 MCP stdio 服务器,例如:'claude mcp add --scope user pomerado -- npx -y -p pomerado pomerado-mcp mint --root ~/pomerado-integrations'。添加完成后,你只需让代理“mint”一个集成:说明网站名称、描述任务,并说明它应该只读取,还是也可以进行修改。
开始之前我需要准备什么?你需要 macOS 或 Linux 系统、Node 24.21 或更高版本、一个能运行本地服务器的 MCP 客户端(Claude Code、Codex、Cursor、VS Code、Claude Desktop 或 Gemini CLI),以及一个 OpenAI API 密钥。Pomerado 只在铸造过程中使用 OpenAI 模型,运行已完成的集成时不需要。
开始铸造前有什么需要注意的地方吗?每个铸造任务只有 20 分钟的实际工作时长(等待你回答的时间不计入),且仅支持 macOS 或 Linux(不支持 Windows)。如果登录表单的字段或提交地址指向与你铸造所针对的网站不同的域名,该表单会被直接拒绝。
集成登录时,我的登录信息会去哪里?Pomerado 只会把你的凭据输入到网站本身,或你通过 authenticationOrigins 明确允许的登录地址中;它从不保存登录信息、验证码或答案,并且会拒绝指向其他地址的登录页面。
什么是铸造?铸造就是构建过程:Pomerado 的代理会驱动一个真实的 Chromium 浏览器,把所描述的任务执行一次;随后其 Guardian 组件会在保存集成之前,审查每一次浏览器操作以及最终生成的源代码。
只读权限和写入权限有什么区别?只读集成只查看网站内容,而写入集成可以提交表单或进行预订。代理必须有意识地选择写入权限;如果在铸造任务进行中要把只读铸造切换为写入,Pomerado 会先询问你。
为什么不直接使用计算机操作代理?铸造出的集成会重放一套固定且经过审查的步骤,而不是每次都让代理在实时页面上逐个点击。README 中称,这种方式比计算机操作类方案快得多,也更可靠。
Pomerado Cloud 相比开源核心多了什么?Pomerado Cloud 增加了集成及其任务的托管、OAuth 授权代理和已保存的登录信息、对每个集成的访问控制、可处理机器人防护的托管浏览器集群,以及网站变更时的自动故障检测与修复。
作者
Pomerado
大小
26.6 MB
星标
1.8K
时长
1个月
提交 · 90 天