Ground API

GroundAPI

Data API for AI Agents

Website · Docs · MCP Endpoint · CLI

中文 | English

______________________________________________________________________

GroundAPI为AI代理提供了一个统一的数据层-- 11工具 涵盖金融、信息和生活服务。一个API密钥，三种访问方法： REST API, 主控程序，以及 命令行界面.

  

目录

• 快速开始
• MCP工具参考

- 金融（5种工具） - 信息（4个工具） - 生活服务（2个工具）

• REST API
• CLI参考
• 代理技能
• 自托管MCP服务器
• 定价

快速开始

获取API密钥： groundapi.net — 500个免费电话/月，不需要信用卡。

选项1:MCP（推荐用于AI代理）

添加到Claude Desktop、Cursor、Windsurf或任何兼容MCP的客户端：

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

选项2:REST API

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

选项3:CLI

pip install groundapi-cli
groundapi config set-key YOUR_API_KEY
groundapi stock --symbol 600519

______________________________________________________________________

MCP工具参考

金融（5种工具）

finance_stock --证券数据

A股股票、指数和ETF的多功能查询。支持 11个数据维度 以及多股票比较。

11个可用方面：

# Quick overview
finance_stock(symbol="600519")

# Deep dive with multiple aspects
finance_stock(symbol="600519", aspects="quote,technical,financial")

# Search by name
finance_stock(keyword="平安")

# Compare multiple stocks
finance_stock(symbol="601398,601939,600036", aspects="quote")

# Index / ETF
finance_stock(symbol="000001.SH", aspects="kline,technical")  # SSE Composite
finance_stock(symbol="510300", aspects="quote")                # CSI 300 ETF

finance_market --市场概况

全市场数据：主要指数、热门股票、行业轮换、IPO日历、异常信号。

范围： overview （指数+情绪）· hot （限制涨跌池，连胜）· sectors （概念和行业列表）· ipo （IPO日历）· signals （异常检测）

finance_market()                                    # Today's market
finance_market(scope="hot")                         # Limit-up/down stocks
finance_market(scope="sectors", sector="AI")        # AI sector constituents
finance_market(scope="ipo")                         # IPO calendar

finance_screen --股票筛选器

具有20多个维度和预设过滤器组合的多标准筛选。

finance_screen(industry="银行", pe_max=10)                       # Low-PE bank stocks
finance_screen(min_dividend_yield=3, sort_by="dividend_yield")   # High dividend
finance_screen(concept="AI")                                      # AI concept stocks
finance_screen(filter_preset="low_pe_high_div")                  # Preset: value picks

finance_search --通用搜索

搜索范围 11780+证券：股票、概念、行业、ETF、指数。

finance_search(keyword="芯片", type="etf")        # Chip ETFs
finance_search(keyword="AI", type="concept")       # AI concept indices
finance_search(keyword="沪深300", type="index")    # CSI 300

finance_gold_price --贵金属

finance_gold_price()   # Gold, silver, platinum prices

______________________________________________________________________

信息（4个工具）

info_search --网络搜索

info_search(query="AI Agent trends 2026", count=20, recency="oneWeek")

info_news --新闻头条

info_news(category="finance", limit=10)
info_news(category="tech")

info_trending --热门话题

微博、抖音、知乎等热门搜索排名。

info_trending()

info_bulletin --每日简报

info_bulletin()   # Morning news digest

______________________________________________________________________

生活服务（2个工具）

life_weather --天气

life_weather(city="北京", forecast=True)
life_weather(location="39.9,116.4")

life_calendar --日历和交易日

life_calendar()                  # Today: lunar date, solar terms, holiday, trading day
life_calendar(date="2026-05-01") # Specific date

______________________________________________________________________

REST API

基本URL: https://api.groundapi.net

所有端点都需要 X-API-Key 头球

# Stock overview
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.groundapi.net/v1/finance/stock?symbol=600519&aspects=overview"

# Multi-aspect deep dive
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.groundapi.net/v1/finance/stock?symbol=600519&aspects=quote,technical,financial"

# Market overview
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.groundapi.net/v1/finance/market?scope=overview"

# Stock screening
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.groundapi.net/v1/finance/stock/screen?industry=银行&pe_max=10"

# Web search
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.groundapi.net/v1/info/search?q=AI+Agent&count=10"

# Weather
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.groundapi.net/v1/life/weather?city=北京&forecast=true"

API完整文档： docs.groundapi.net

______________________________________________________________________

CLI参考

安装

pip install groundapi-cli
groundapi config set-key YOUR_API_KEY

金融

# Stock quotes
groundapi stock --symbol 600519                            # Latest quote
groundapi stock --keyword 贵州茅台                          # Search by name
groundapi stock --symbol 600519 --date 2024-12-31          # Specific date
groundapi stock --symbol 600519 --days 30                  # Last 30 days
groundapi stock --symbol 600519 --days 30 --include technicals  # With technicals

# Screening
groundapi screen                                           # Default ranking
groundapi screen --industry 白酒 --pe-max 30               # Industry + PE filter
groundapi screen --sort-by total_market_cap --limit 10     # Top 10 by market cap

# Market overview
groundapi market                                           # Indices + macro
groundapi market --include sectors,valuation               # With sectors + valuation
groundapi market --sector 半导体 --type industry           # Sector drill-down

# Finance search
groundapi fsearch 芯片                                     # Search securities
groundapi fsearch AI --type concept                        # AI concept indices

# Gold price
groundapi gold                                             # Precious metals prices

信息

groundapi search "AI Agent"                                # Web search
groundapi search "AI Agent" --count 20 --recency oneWeek   # With filters
groundapi news                                             # Finance news
groundapi news --category tech --limit 10                  # Tech news
groundapi trending                                         # Trending topics
groundapi bulletin                                         # Daily briefing

生活服务

groundapi weather --city 北京                               # Current weather
groundapi weather --city 北京 --forecast                    # 7-day forecast
groundapi weather --location 39.9,116.4                    # By coordinates
groundapi calendar                                         # Today's calendar info

______________________________________________________________________

代理技能

将GroundAPI工具结合到自动化工作流程中的预构建技能。在Cursor、OpenClaw或Smithery中安装：

______________________________________________________________________

自托管MCP服务器

在本地运行MCP服务器（本地AI客户端的stdio传输）：

pip install -r requirements.txt
python mcp_server.py

或者连接到托管的MCP端点（无需部署）：

https://mcp.groundapi.net/mcp

______________________________________________________________________

定价

获取API密钥： groundapi.net.

链接

• 网站： groundapi.net
• API文件： docs.groundapi.net
• MCP端点： https://mcp.groundapi.net/mcp
• PyPI上的CLI： 地面API客户端
• 孙： mcp.so上的GroundAPI

许可证

MIT——仅提供技能、MCP服务器包装和文档。GroundAPI是一种商业API服务。