AIAdPlacer MCP 接口文档

一、统一调用协议

所有工具走标准 MCP JSON-RPC 风格（轻量化实现），无会话、无握手。

1.1 健康检查

GET http://47.253.159.62:5002/api/v2/mcp/pdooh/health
→ {"service":"pDOOH A2A MCP Server","status":"ok","tools_count":19,
   "mcp_endpoint":"/api/v2/mcp/pdooh/tools/call"}

1.2 工具发现

GET /api/v2/mcp/pdooh/tools/list
→ { "tools": [ {name, description, inputSchema}, ... ] }   // 19 项

1.3 工具调用

POST /api/v2/mcp/pdooh/tools/call
Headers: X-API-Key: pdooh-agent-key-2026
        Content-Type: application/json
Body:
{
  "name": "pdooh_query_screens",
  "arguments": { "city": "广州", "min_house_price": 8, "limit": 10 }
}

Response (MCP content[] 包装):
{
  "content": [
    { "type": "text",
      "text": "[{\"id\":1,\"name\":\"天河城社区门禁屏\",...}]" }
  ]
}

1.4 错误码（实测）

二、19 工具速查

三、完整 inputSchema

3.1 智能屏 / 道闸 / 单元门

3.2 LED / 电梯 / 梯影 / 门禁

3.3 城市索引 / 汇总 / L9 / 丰田

3.4 客户数据

3.5 投放管理（8 工具）

四、实拉返回样例

4.1 pdooh_query_screens

[
  {"id":1,"name":"天河城社区门禁屏","city":"广州","district":"天河区",
   "lat":23.1291,"lng":113.3642,"house_price":8,
   "tags":["高端白酒","母婴","美妆"],"impressions_per_day":3200}
]

4.2 pdooh_query_customers

[
  {"id":7553,"data":{"备注":"","座机":"","手机":"","状态":"公海",
   "职务":"13805771602","行业":"家居建材","部门":"","联系人":"营销总监",
   "决策城市":"","品牌名称":" ","客户简称":" ","组织机构":""},
   "phone":"","brand":"","city":"","industry":"家居建材",
   "created_at":"2026-06-07T23:08:17.143160"}
]

4.3 pdooh_compliance_check

{"passed":true,"issues":[],"suggestion":"可以投放","reviewer":"AI-Compliance-v1.0"}

4.4 pdooh_audience_insight

{"product_desc":"","target_city":"广州","matched_tags":[],
 "recommended_screens":[{"id":1,"name":"天河城社区门禁屏",...}]}

4.5 pdooh_query_city_summary

[
  {"city":"重庆市市辖区","total":3245,"details":{"门禁":2435,"单元门":810}},
  {"city":"上海市市辖区","total":3088,"details":{"门禁":2575,"单元门":513}},
  {"city":"广州市","total":2883,"details":{"门禁":2172,"单元门":711}}
]

五、典型 Agent 调用链

链 A：高端白酒 → AI 选点 → 建计划

curl -X POST http://47.253.159.62:5002/api/v2/mcp/pdooh/tools/call \
  -H "X-API-Key: pdooh-agent-key-2026" -H "Content-Type: application/json" \
  -d '{"name":"pdooh_audience_insight","arguments":{
        "product_desc":"高端白酒，目标高净值人群",
        "target_city":"广州","budget_hint":30000}}'

curl -X POST .../tools/call -d '{"name":"pdooh_query_screens","arguments":{
        "city":"广州","tags":["高端白酒"],"min_house_price":8,"limit":10}}'

curl -X POST .../tools/call -d '{"name":"pdooh_compliance_check","arguments":{
        "content":"品味传世，高端白酒限时品鉴","industry":"白酒"}}'

curl -X POST .../tools/call -d '{"name":"pdooh_create_campaign","arguments":{
        "name":"高端白酒-广州-周投","screen_ids":[1,2],
        "start_date":"2026-06-15","end_date":"2026-06-21",
        "budget":30000,"creative_text":"品味传世，高端白酒限时品鉴"}}'

链 B：客户筛选 → 商务跟进

curl -X POST .../tools/call -d '{"name":"pdooh_query_customers","arguments":{
        "city":"广州市","industry":"汽车","limit":20}}'

链 C：投放后查报告

curl -X POST .../tools/call -d '{"name":"pdooh_query_report","arguments":{
        "campaign_id":42,"start_date":"2026-06-01","end_date":"2026-06-30"}}'

六、部署 & 接入

6.1 服务端口

6.2 MCP 端点

6.3 接入 WorkBuddy / Claude / Cursor

WorkBuddy 通过 WorkBuddy专家-管理员 技能导入 skill.yaml，即可让 5 角色 AI 团（析客/瑞思/数析/竞析/首席）直接调用上述 19 个工具。