OpenDirect MCP服务器v2.1
IAB技术实验室OpenDirect v2.1规范的完整模型上下文协议实现,用于程序化直接广告库存管理。
快速链接
概述
OpenDirect使出版商能够使用编程接口提供优质保证库存。此MCP服务器为所有OpenDirect v2.1对象和工作流提供完整的模式定义和工具。
安装
# Copy opendirect-mcp-server.json to your MCP configuration directory
cp opendirect-mcp-server.json ~/.mcp/servers/
# Or use with MCP client
mcp-client connect opendirect-mcp-server.json核心资源
- 组织 -广告商、代理商、出版商
- 账户 -买家-广告商关系
- 订单 -包含预算和日期的活动计划
- 线条 -特定产品的行项目
- 产品 -可用库存目录
- 创意作品 -广告资产
- 作业 -创造性的直线映射
- 安置 -广告单元规格
- 变更请求 -订单修改请求
- 消息 -买卖双方沟通
规约引用
- AdCOM -广告通用对象模型
- OpenRTB -实时竞价协议
- DP-AA -数字户外扩展
主要特点
完整的架构覆盖
所有具有完整属性定义的OpenDirect v2.1对象:
- OpenDirect核心对象(帐户、订单、行、产品等)
- AdCOM域对象(创意规格、设备、地理、网站、应用程序等)
- OpenRTB对象(交易、PMP、注册、源)
MCP工具
创建和管理对象的10个主要工具:
create_account-创建买家广告商帐户create_order-创建广告订单create_line-创建行项目create_creative-上传广告创意create_assignment-将创意分配到线条search_products-搜索库存create_organization-注册组织create_change_request-请求订单更改send_message-发送消息update_line_booking_status-更新预订状态
工作流提示
常见场景的指导工作流程:
order_workflow-完成订单下达工作流程product_discovery-寻找合适的库存creative_specs-获取创意需求
示例用法
创建订单
{
"tool": "create_order",
"arguments": {
"name": "Q1 2025 Campaign",
"accountid": "acc_12345",
"publisherid": "pub_67890",
"currency": "USD",
"budget": 500000,
"startdate": "2025-01-01T00:00:00Z",
"enddate": "2025-03-31T23:59:59Z"
}
}创建行项目
{
"tool": "create_line",
"arguments": {
"name": "Homepage Banner",
"orderid": "ord_98765",
"productid": "prod_homepage_001",
"startdate": "2025-01-01T00:00:00Z",
"enddate": "2025-01-31T23:59:59Z",
"ratetype": "CPM",
"quantity": 1000000
}
}预订状态工作流
Draft → PendingReservation → Reserved → PendingBooking → Booked → InFlight → Finished其他状态:已停止、已取消、暂停、已过期、已拒绝、更改待定
费率类型
- 每千次展示成本 -每千次展示成本
- CPMV -每千次可查看印象的成本
- 中国共产党 -每次点击成本
- 持续专业发展 -每日成本
- 按时计价 -固定利率定价
标准符合性
- ISO-639-1(语言)
- ISO-3166(国家/地区)
- ISO-4217(货币)
- IAB技术实验室内容分类
- IQG 2.1媒体评价
文档
看 OPENDIRECT_DOCUMENTATION.md 有关以下内容的完整详细信息:
- 所有对象模式和属性
- 工作流图
- 业务规则和验证
- AdCOM规范
- OpenRTB集成
- 用例和示例
许可证
IAB技术实验室-知识共享署名3.0 https://creativecommons.org/licenses/by/3.0/
版本
OpenDirect v2.1决赛(IAB技术实验室2018-2024)
