Opedd — Licensed Content for AI

opedd-mcp

获得许可、权利已清理的 AI Agent 内容 — 为 RAG、AI 搜索和大模型 grounding 提供未经许可的抓取之外的替代方案。

让 AI 助手（Claude Desktop、Cursor、Windsurf 或任何兼容 MCP 的宿主）能够自主发现、购买和验证内容许可——在对话过程中即可完成，无需打开浏览器。每份许可都记录在 Tempo 上的公开注册表中，并附有加密证明。

与通用搜索 API 不同，Opedd 返回的内容带有可验证的许可密钥——权利已清理，并留有可提交给法务团队的记录。

快速开始

npx opedd-mcp

然后将其添加到你的 MCP 宿主（请参阅下方的 Claude Desktop / Cursor / Windsurf 设置）。发现和验证工具无需配置即可使用；购买和内容检索则需要来自 opedd.com 的可选 API 密钥。

托管端点 — 无需安装（mcp.opedd.com）

想要零安装？相同的 20 个工具已通过 https://mcp.opedd.com/mcp（Streamable HTTP）托管提供。身份验证使用包含任意 Opedd 密钥的 Authorization: Bearer 标头——公开发现工具完全无需身份验证。

Claude Messages API（生产环境中的 Agent）：

{
  "mcp_servers": [{
    "type": "url",
    "url": "https://mcp.opedd.com/mcp",
    "name": "opedd",
    "authorization_token": "opedd_buyer_live_..."
  }]
}

OpenAI Responses API：

{
  "tools": [{
    "type": "mcp",
    "server_label": "opedd",
    "server_url": "https://mcp.opedd.com/mcp",
    "authorization": "opedd_buyer_live_..."
  }]
}

claude.ai / Claude Desktop 自定义连接器（所有套餐）：Settings → Connectors → Add custom connector → URL https://mcp.opedd.com/mcp；为需要凭据的工具添加 Authorization: Bearer <your key> 请求标头。

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "opedd": {
      "url": "https://mcp.opedd.com/mcp",
      "headers": { "Authorization": "Bearer ${env:OPEDD_KEY}" }
    }
  }
}

密钥路由：opedd_sk_*（旧版 opedd_pub_*）→ 发布者工具 · opedd_buyer_* → 内容检索 · ent_* → 批量信息流 · 买家门户 JWT → 审计/合规工具。你的密钥会随每个请求转发，网关不会存储密钥。

功能

向任何 AI 助手提供最多 20 个工具（部分工具需视环境变量而定）：

每个工具都带有 title 和 MCP 注解（readOnlyHint、destructiveHint、idempotentHint、openWorldHint），让助手能够判断哪些工具只读取信息，哪些会花费资金或写入数据（v0.12.0）。

始终可用 — 发现 + 入驻 + 权利标示

Tool	Description
search_content	免费发现。 对所有可授权内容进行全文搜索（v0.8.0）——返回按相关性排序的匹配结果，包含出版方、价格、字数和描述摘要；用引号搜索词组，用 -word 排除词语。不返回文章正文——请使用 search_passages 实际阅读
search_passages	按答案付费，或包含在月度订阅中。 提出问题，获取回答问题的授权段落及引文。按答案付费：答案每使用一篇文章就收取一次费用，价格按该出版方的单篇文章价格计算；每个段落最多 300 个词或文章的 25%，按累计字数计算。月度 AI 答案订阅（v0.12.0）：从订阅开始时起，答案包含在订阅中，不设上限。可使用 publishers、published_after、published_before、max_results（1–10，默认值为 5）缩小范围，并使用 max_charge_cents 限制问题的费用。需要带有 search 范围的买家密钥。24 小时内重复提问免费
lookup_content	根据 URL 查找文章——返回标题、出版方和授权方式，或说明该文章尚未收录在 Opedd 中
request_publication	请求在 Opedd 尚未收录的出版物上线时收到通知（url + email；无需密钥）
verify_license	验证许可证密钥——返回有效性、文章、出版方和公开记录证明
browse_registry	浏览 Opedd 公共注册表——列出已颁发的 LICENSES（浏览出版方本身请使用 publisher_directory）
publisher_directory	浏览 Opedd 公共出版方目录——分页列出出版方及其文章数量、定价和示例文章（AI 实验室用于买家发现的主要入口）
place_licence_order	为一个或多个出版方下单授权：AI 答案（monthly 全文，或 metered 按请求付费的片段，≤300 个词 / 25%）、完整目录（archive、one_time：截至下单日期发布的全部内容，永久保留，不用于 AI 训练）、AI 训练（one_time，过往内容）、客户端展示（monthly × 终端客户端）。按月订购 AI 答案时，可选设置 include_archive: true，为每个出版方添加其完整目录，以实现完整访问。每个出版方均有独立的附表和定价；返回订单、订单项、unavailable 出版方及 hosted_invoice_url。需要 OPEDD_BUYER_JWT 和 terms_accepted: true
rsl_get	获取出版方的 RSL Standard 清单——公共发现入口；jsonld: true 返回 CDSM Article 4(3) 签名回执（Phase 12 W1.1）
detect_platform	检测 URL 背后的内容平台——返回针对 Substack / Beehiiv / Ghost / Medium / Brevo / 自定义平台的建议入驻工作流（Phase 12 W3.1）

需要 OPEDD_BUYER_TOKEN（opedd_buyer_live_*）——一个密钥即可用于搜索、文章和信息流（v0.12.0）

Tool	Description
get_content	获取账户持有的任何订单下的授权文章——AI 答案月度订单和客户端展示订单可获取全文；按请求付费的许可证通过 search_passages 阅读（403 SEARCH_ONLY_LICENCE）；包含 7 个 RAG 元数据字段（author、language、word_count、content_hash、image_urls、canonical_url、tags）

信息流工具——OPEDD_BUYER_TOKEN + order_id，或订单的 OPEDD_ACCESS_KEY（ent_*）

Tool	Description
list_feed	列出许可证订单涵盖的文章，并支持使用 since 获取增量信息流。AI 训练和完整目录订单包含完整的 content_body（content_access: "included"）；月度订单仅支持发现（content_access: "retrieval_per_article"，通过 get_content 获取正文）；按请求付费的订单为 "search_only"。使用买家密钥时，传入 order_id（账户持有一个有效订单时可选）
stream_feed_ndjson	通过 NDJSON 线格式每次调用批量导出最多 1000 篇文章。内容约定和凭证与 list_feed 相同

需要 OPEDD_BUYER_JWT（Supabase JWT）——买家账户、审计、合规和证明入口

工具	描述
get_buyer_account	获取买家资料和脱敏后的 API 密钥列表——采用买家控制面板的思路
list_licence_orders	买家的许可订单及订单项；提供 order_id 时，还会返回每个订单项的 Schedule 文档及其 SHA-256（记录在 Tempo 上的指纹）。也支持使用审计范围限定的 OPEDD_BUYER_TOKEN
get_audit_events	逐事件审计账本，内含公开记录（Tempo）的纳入证明（Phase 9.x + 10 M5）
get_compliance_dossier	用于采购抗辩的合规档案，映射检索记录与许可条款（Phase 11 M4）
article_53_attestation	许可的签名合规证明（JWT）——买家交给法务／采购部门的材料（Phase 12 W1.4）

需要 OPEDD_PUB_BEARER（opedd_sk_；旧版 opedd_pub_ 仍可使用）——发布方

工具	描述
list_publisher_content	列出你自己的文章及其定价和统计数据
push_content	将你的文章推送到 Opedd，供 AI 买家获取许可——每次调用可推送 1–100 篇（必填 title／url／html_body，其余均为可选）。无需编写代码，即可直接通过 AI 助手上架历史内容或新文章。

合规材料（发布方与买家各自使用，绝不混淆）

根据 Opedd 平台不变量（W1.6 修订）：

• rsl_get(publisher_id, jsonld=true) → 发布方的 CDSM Article 4(3) 退出声明（基于预留状态的签名 JSON-LD 回执）。
• article_53_attestation(license_id) → 买家侧的签名合规证明（范围限定为单个许可的 HS256 JWT）。
• get_compliance_dossier(from, to) → 全面的采购抗辩档案，涵盖双方（已遵守发布方的 CDSM 预留 + 买家证明材料链）。

这些材料适用于不同的审计抗辩模式，且绝不共用传输格式。工具描述中会直接引用 W1.6 不变量。

安装

npm install -g opedd-mcp

或使用 npx 直接运行：

npx opedd-mcp

配置

设置环境变量以预先配置服务：

变量	必需	描述
OPEDD_BUYER_TOKEN	可选	买家 API 密钥（opedd_buyer_live_*；沙盒使用 opedd_buyer_test_*）——启用 search_passages（需 search 范围）、get_content、list_feed + stream_feed_ndjson（需提供 order_id）
OPEDD_ACCESS_KEY	可选	订单的企业访问密钥（ent_*）——可作为 list_feed + stream_feed_ndjson 的替代凭证
OPEDD_BUYER_JWT	可选	来自买家门户的 Supabase 会话 JWT——启用 place_licence_order + list_licence_orders + get_buyer_account + get_audit_events + get_compliance_dossier + article_53_attestation
OPEDD_PUB_BEARER	可选	发布方 API 密钥（opedd_sk_<32-hex>，自 2026-08-27 起为标准格式；旧版 opedd_pub_<32-hex> 密钥仍可使用）——从 Opedd 控制面板的 Settings → Developers 获取。启用 list_publisher_content（以及 include_body）和 push_content。
OPEDD_API_KEY	已弃用	旧版发布方 API 密钥（op_...）——过渡期间作为备用；opedd-backend Phase C 部署后将停止使用。请迁移至 OPEDD_PUB_BEARER。
OPEDD_API_URL	可选	覆盖 API 基础 URL（默认：Opedd 生产环境）
OPEDD_MCP_TELEMETRY	可选	设为 0 可停用匿名使用情况遥测（见下文）

获取 Stripe 支付方式 ID：在 Stripe 账户中保存一张卡，然后通过 Stripe API 获取 pm_... ID。

匿名使用情况遥测

为了解 AI 助手如何使用此服务，opedd-mcp 会为每次工具调用发送匿名遥测数据：仅包括工具名称、调用耗时、是否成功以及服务版本，外加一个每个进程随机生成的 ID。它绝不会发送工具参数、响应、您的电子邮件、API 密钥、令牌、内容或 IP 地址。数据会发送至 Opedd 的 PostHog（欧盟区域）。

如要选择退出，请在启动服务前设置以下任一环境变量：

OPEDD_MCP_TELEMETRY=0
# or the cross-tool standard:
DO_NOT_TRACK=1

选择退出后，不会创建遥测客户端，也不会发送任何数据。

Claude Desktop 设置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "opedd": {
      "command": "npx",
      "args": ["opedd-mcp"],
      "env": {
        "OPEDD_BUYER_TOKEN": "opedd_buyer_live_..."
      }
    }
  }
}

Cursor / Windsurf 设置

添加到 MCP 设置中：

{
  "opedd": {
    "command": "npx opedd-mcp",
    "env": {
      "OPEDD_BUYER_TOKEN": "opedd_buyer_live_..."
    }
  }
}

使用示例

配置完成后，您可以向 AI 助手提问：

“查找这篇文章的许可选项：https://theinformation.com/articles/...”

“Opedd 的出版物对欧盟芯片补贴有哪些说法？请引用相关段落。”——使用 search_passages

“验证许可证密钥 OP-XXXX-XXXX，并告诉我它涵盖哪些内容。”

“浏览 The Information 出版商的最新许可证。”

Phase 12 Wave 1 + 3 surfaces (v0.3.0)

“出版商 8268c353-ffa3-4db3-bbb2-90ddbbb43e41 授予了哪些许可？获取 RSL 清单。”——使用 rsl_get

“为该出版商的保留状态获取一份 CDSM Article 4(3) 签名回执——设置 jsonld: true。”——通过内容协商使用 rsl_get

“为我们的许可证 11111111-... 生成一份涵盖最近 90 天的签名合规证明。我需要这份文件供采购审计委员会使用。”——使用 article_53_attestation（需要 OPEDD_BUYER_JWT）

“这家出版商刚刚注册：https://noahpinion.substack.com。我们应该使用哪种入驻工作流？”——使用 detect_platform

“浏览 Opedd 目录中的金融分类——显示至少有 50 篇文章的出版商。”——使用 publisher_directory

“我的买家账户里有什么？显示我的有效 API 密钥。”——使用 get_buyer_account（需要 OPEDD_BUYER_JWT）

助手会调用相应的 Opedd 工具并向您显示结果。

付款

没有账户？Agent 可以当场为一条答案付款。 使用与 search_passages 相同的请求体（{"query": "..."}）向 https://api.opedd.com/agent-answer 发送 POST 请求。响应为 HTTP 402，其中包含价格（答案使用的每篇文章按其出版物各自的价格计费）、许可证和买家条款。通过 Machine Payments Protocol 使用银行卡付款（Stripe 共享支付令牌，至少 0.50 USD；剩余金额会作为余额存入随答案返回的搜索密钥），然后重试。机器可读格式：api.opedd.com/openapi.json。

按答案付费的搜索费用会计入您买家账户中的银行卡（opedd.com/buyer/billing）；许可证订单通过 Stripe 付款。单篇文章购买（人工转载，purchase_license）已于 2026-10-26 停止提供。

开发

git clone https://github.com/Opedd/opedd-mcp
cd opedd-mcp
npm install
npm run dev   # runs with tsx (no build step)
npm run build # compiles to dist/

Opedd 与搜索 API 的对比

	Opedd	通用搜索 API
可获得的内容	经授权的内容 + 许可证密钥 + 公共记录证明——一次 API 调用即可全部获取	抓取的网页内容，无使用权
内容交付	通过 API（JSON）提供完整文章文本——固定费用许可证支持批量获取，筛选型许可证按次（计量）收费；通过 Webhook 实时推送	抓取的摘要或完整页面转储
内容质量	精选出版商内容（细分领域 B2B 新闻简报、专家分析）	开放网络上的任何内容
权利	每次使用均有可验证的许可证，并经出版商授权	未取得权利许可
证明	公共记录（Tempo）——可独立验证	无
合规性	签名声明 + 完整来源链	无来源信息
定价	出版商自行定价	由平台决定
交付方式	文章 API、批量信息流（JSON 数据流）、买方 Webhook（推送）	仅支持查询-响应
协议	REST + 原生支持 MCP	仅支持 REST

Opedd 是面向 AI 的授权内容交付层，而不只是一个许可封装层。出版商上传内容，你通过附带许可证的 API 获取内容。一次集成即可让你的数据管道同时获得内容及其合法使用权。

了解更多

• 面向 AI Agent 的 Opedd — 完整文档、代码示例、端点参考
• API 文档 — 包含 Agent 端点的 OpenAPI 规范
• 验证许可证 — 在公共记录中检查任意许可证密钥

许可证

MIT