placements

Essentras MCP 服务

通过 AI Agent 购买媒体报道。

Essentras 是付费媒体版位交易平台。这个 MCP 服务让整个商品目录都能被机器读取：Agent 可以按预算、域名权威度、地理位置、主题和链接政策搜索 3,800 多家经过审核的媒体，计算购物篮价格，并将结账链接交给买家。无需账户、API 密钥，也无需协商。

已作为 com.essentras/placements 列入官方 MCP 注册表。

快速开始

将以下内容添加到任意 MCP 客户端（Claude Desktop、Claude Code、Cursor、VS Code）：

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

然后提出你的需求：

查找价格低于 400 美元、提供 dofollow 链接的美国科技媒体，然后计算最合适的三家媒体的价格。

我有 2,000 美元预算，用于在英国发布金融科技报道。能买到什么？

在 Business Insider 发布版位要多少钱，需要多长时间？

工具

工具	功能
search_outlets	按 max_price、country、region、language、topic、min_da、dofollow、indexed 搜索，并支持排序和分页。返回包含固定美元价格、处理时间、链接政策和稳定 ID 的报价。
get_outlet	根据 ID 获取单家媒体的完整详情。
quote_placements	计算购物篮价格。返回商品明细、任何批量折扣、最终总额和 checkout_url。不收费，也不会创建订单。

这三项工具均标注为只读且幂等。

Agent 永远不会付款

这是设计上的决定，不是有待解除的限制。

服务不保存任何付款方式，也无法收款。quote_placements 会返回 checkout_url；买家打开链接后，会看到总额相同的购物篮，并在 essentras.com 上付款。因此，即使有人对 Agent 过于信任，最坏的情况也只是生成一个他们不想要的购物篮，而不是被收取未经授权的费用。

服务不具备某种能力，比要求模型遵守它可能会忽略的指令更有保障。

报价就是价格

我们提供 quote_placements，而不是让你自行累加标价，因为购物篮总价并非各项价格之和：购买 3 个和 5 个版位时适用批量折扣。网页、REST API、MCP 服务和实际扣款都使用同一个定价函数，因此 Agent 报出的金额就是买家实际支付的金额。

费用在结账时收取，而不是在发布时收取。如果版位未能发布，或超出规定的处理时间，订单将退款。

纯 HTTP

MCP 服务提供的所有功能也都有对应的 REST 端点，并由 OpenAPI 3.1 描述。

curl "https://essentras.com/api/agent/v1/outlets?country=US&dofollow=true&max_price=400&limit=3"

curl -X POST https://essentras.com/api/agent/v1/quote \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"id":"business-insider"},{"id":"msn"}]}'

可查看 examples/quickstart.sh，了解可运行的操作演示。

端点
/api/agent/v1	服务说明和结账模型
/api/agent/v1/openapi	OpenAPI 3.1
/api/agent/v1/feed	商品 Feed，JSONL，Agentic Commerce Protocol 格式
/.well-known/agent.json	发现清单
/llms.txt	以文字介绍我们销售的商品

协议支持

采用 Streamable HTTP，并有意兼容两个时期的协议。服务实现了 2026-07-28 版本（无状态、server/discover、每个请求的 _meta、resultType、缓存提示），并且支持更早的 initialize 握手，因为目前仍有大量客户端使用旧方式连接。对于不支持的版本，服务会返回包含其支持版本列表的标准 UnsupportedProtocolVersionError，让客户端可以重试，而不必猜测。

限制与如实说明

• 读取和引用是公开的，并按 IP 限流。无需设置访问门槛：API 返回的所有内容在网站上都已公开。
• JSON-RPC 批处理设有上限（20 条消息，其中 5 条为工具调用）。不设上限的批处理会轻易耗费大量他人的数据库时间。
• 每笔订单只能选择一家媒体，因此 quote_placements 不接受数量参数。结账交接流程无法表达数量，而报价一个购物车无法复现的组合，还不如不支持。
• 大多数版位以普通编辑文章的形式发布，不标注赞助内容。少数版位会带有赞助或低调的披露说明，每项报价都会在 link.disclosure 中注明。不要假设整个目录中的版位都属于其中一种。
• 目录现有的内容就是如此：商业、科技和金融领域资源丰富，但部分美国一线媒体较少。请搜索目录，而不要想当然地认为其中有某家媒体。

链接

• 文档：essentras.com/agents
• 市场：essentras.com/publishers
• 联系方式：essentras.com/contact

许可证

MIT。请参阅 LICENSE。