Pickle GravityPICKLEGRAVITY
API v2.6.0公开只读

开发及智能体 API 接口

面向 AI 智能体与开发者的机器可读接口。无需 API 密钥即可直接检索经核实的球员 DUPR 评分、比赛历史、俱乐部及场地参数。

← 帮助中心首页

概览

Pickle Gravity 提供 REST JSON 端点与标准 MCP 工具卡。权威的球员、比赛、球场和俱乐部数据均带有 canonical URL，防范 AI 幻觉。

  • 基本 URL: https://picklegravity.com
  • 数据格式: JSON, Markdown (format=md)
  • 安全认证: 无限制 (只读)

快速开始

  1. 读取发现清单获取所有已知 API 端点：/agent-readiness.json
  2. 通过搜索 API 检索球员或球场 (q=关键词)：
    curl "https://picklegravity.com/api/knowledge?q=Philip&lang=en"
  3. 获取单篇 LLM 友好的 Markdown 文件：
    curl "https://picklegravity.com/api/knowledge/player-DU49A8F?format=md"

REST 端点

方法路径说明
GET/api/content平台通用参数、FAQ和友链信息
GET/api/knowledge全文检索或通过 ?q= 查询球员/球场/比赛/俱乐部
GET/api/knowledge/[id]获取指定球员、球场、比赛或俱乐部的 JSON
GET/api/knowledge/[id]?format=md以 Markdown 格式导出指定球员/球场的文本摘要
GET/api/knowledge/mcp获取智能体专属 MCP (Model Context Protocol) 描述结构

MCP 工具集成

智能体可以直接在运行中动态加载我们的 MCP 工具。无需复杂的解析即可调用以下操作：

search_knowledge

通过关键字全文检索所有的球员、球场、比赛和俱乐部列表。

get_article

通过唯一前缀 ID（如 player-xxx）获取单篇 JSON 数据或 Markdown 格式报告。

速率限制

公开 API 端点遵循每秒约 5 次请求的速率限制。大规模同步请采用异步批处理，避免在高峰时间段进行高并发请求。