快速开始 | GroundAPI

1. 注册并获取 API Key

前往 GroundAPI 控制台注册账号，创建一个 API Key。Key 只展示一次，请妥善保存。

2. 发起第一个请求

查询贵州茅台的最新行情：

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/stock?symbol=600519"

3. Python 示例

import httpx
 
resp = httpx.get(
    "https://api.groundapi.net/v1/finance/stock",
    params={"symbol": "600519"},
    headers={"X-API-Key": "sk_gapi_xxxxx"},
)
print(resp.json())

4. MCP 配置

在 Claude Desktop 或 Cursor 的配置文件中添加：

{
  "mcpServers": {
    "groundapi": {
      "url": "https://mcp.groundapi.net/mcp",
      "headers": {
        "X-API-Key": "sk_gapi_xxxxx"
      }
    }
  }
}

配置后 Claude 即可直接调用 14 个数据工具。

5. 统一响应格式

所有端点返回统一格式：

{
  "success": true,
  "data": { ... }
}

错误时：

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "错误描述"
  }
}

6. 全部端点

金融数据

端点	说明
`GET /v1/finance/stock`	股票搜索/行情/历史/技术指标
`GET /v1/finance/stock/screen`	条件选股和涨跌排行
`GET /v1/finance/market`	市场全景/板块/基金/宏观
`GET /v1/finance/fund`	基金查询/排名/详情

信息服务

端点	说明
`GET /v1/info/search`	网络搜索
`GET /v1/info/scrape`	网页抓取
`GET /v1/info/news`	新闻热点

生活服务

端点	说明
`GET /v1/life/weather`	天气查询
`GET /v1/life/logistics`	物流追踪
`GET /v1/life/ip`	IP 归属查询

7. 免费额度

每月前 500 次调用免费，覆盖所有端点。无需信用卡。