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, которую ваш ИИ-агент может вызывать как инструмент. Для этого достаточно простого текстового описания задачи, без записанного файла 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), и ключ API OpenAI: Pomerado использует модели OpenAI только во время минтинга, а не при работе готовых интеграций.
Есть ли подводные камни перед началом минтинга?На каждую задачу минтинга отводится только 20 минут активной работы (время ожидания ваших ответов не учитывается). Работает только на macOS и Linux, Windows не поддерживается. Форма входа отклоняется сразу, если её поля или адрес отправки указывают на домен, отличный от того, для которого выполняется минтинг.
Куда попадают мои данные для входа, когда интеграция входит в систему?Pomerado вводит ваши учётные данные только на самом сайте или на адрес для входа, который вы явно разрешили через authenticationOrigins. Он никогда не сохраняет логин, код или ответ и отклоняет страницы входа, которые ведут куда-либо ещё.
Что такое минтинг?Минтинг — это процесс сборки: агент Pomerado управляет настоящим браузером Chromium, один раз выполняя описанную задачу. Затем его компонент Guardian проверяет каждое действие в браузере и итоговый сгенерированный исходный код перед сохранением интеграции.
В чём разница между правами на чтение и на запись?Интеграции на чтение только просматривают сайт, а интеграции на запись могут отправлять формы или делать бронирования. Агент должен осознанно выбирать запись, и Pomerado спрашивает подтверждение, прежде чем переключить минтинг с чтения на запись в ходе задачи.
Почему бы просто не использовать агент с управлением компьютером?Созданные интеграции воспроизводят заранее проверенную последовательность шагов, а не заставляют агента каждый раз кликать по живой странице. Согласно README, это делает их значительно быстрее и надёжнее подходов с управлением компьютером.
Что Pomerado Cloud добавляет к открытому ядру?Pomerado Cloud добавляет хостинг ваших интеграций и их задач, посредничество OAuth и сохранённые логины, контроль доступа к каждой интеграции, управляемый парк браузеров, который справляется с защитой от ботов, а также автоматическое обнаружение поломок и их исправление при изменении сайта.
Какие есть похожие проекты?stagehand, api-anything, scout, ruflo, trueforge, newsjack, rea, playwright_mcp
Автор
Pomerado
Размер
26.6 MB
Звёзды
1.8K
Возраст
1 мес
Коммиты · 90 дней