GroundAPI
GroundAPI 为 AI Agent 提供统一的数据层 —— 18 个工具,涵盖金融、信息和生活服务。一个 API Key,三种访问方式:REST API、MCP 和 CLI。
目录
Related MCP server: Real-time Stock MCP Service
快速开始
在 groundapi.net 获取您的 API Key —— 每月 500 次免费调用,无需信用卡。
选项 1:MCP (推荐用于 AI Agent)
添加到 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 600519MCP 工具参考
金融 (6 个工具)
finance_stock — 证券数据
A 股股票、指数和 ETF 的一体化查询。支持 13 个数据维度 和多股对比。
参数 | 类型 | 默认值 | 描述 |
| string | — | 股票代码。对比时使用逗号分隔 (例如 |
| string | — | 按名称搜索 (例如 |
| string |
| 数据维度,逗号分隔 (见下表) |
| int |
| K 线/技术指标的历史范围 |
| string |
| K 线周期: |
13 个可用维度:
维度 | 返回内容 | 使用场景 |
| 快速快照:行情 + 简介 + 财务简报 | “XXXX 表现如何?” |
| 公司全貌、概念、指数成分、资本结构 | “这家公司是做什么的?” |
| 实时价格、PE/PB、五档盘口、涨跌停距离 | “当前价格是多少?” |
| K 线数据 (支持 5/15/30/60 分钟、日、周、月) | “给我看图表” |
| MACD、MA、BOLL、KDJ + 信号检测 (例如 “DIF 上穿 DEA”) | “技术分析如何?” |
| 三大财务报表、季度损益、现金流、分红、预测 | “财务状况如何?” |
| 资金流向 (超大/大/中/小单)、连续流入/流出 | “主力资金在买入吗?” |
| 前十大股东、流通股东、户数趋势、基金持仓 | “主要股东是谁?” |
| 高管、董事、监事 | “管理层是谁?” |
| 分红、增发、解禁、财报日历 | “下次分红是什么时候?” |
| 日内逐笔成交及买卖方向统计 | “今天买盘多还是卖盘多?” |
| 多维度事实聚合 (无观点) | “给我一份完整的数据摘要” |
| 同行业对比表 (PE/PB/市值排名) | “它在行业内排名如何?” |
# Quick overview
finance_stock(symbol="600519")
# Deep dive with multiple aspects
finance_stock(symbol="600519", aspects="quote,technical,financial,flow")
# 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 ETFfinance_market — 市场概览
全市场数据:主要指数、热门股、板块轮动、IPO 日历、异常信号。
参数 | 类型 | 默认值 | 描述 |
| string |
| 数据范围,逗号分隔 |
| string | — | 深入特定板块 |
| string | — | 日期筛选 (YYYY-MM-DD) |
范围: 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 calendarfinance_screen — 选股器
支持 20+ 维度和预设组合的多条件选股。
参数 | 类型 | 描述 |
| string | 行业筛选 (例如 |
| string | 概念筛选 (例如 |
| float | 市盈率范围 |
| float | 最大市净率 |
| float | 市值范围 |
| float | 最小股息率 (%) |
| string |
|
| string | 排序字段 (默认: |
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 picksfinance_search — 通用搜索
搜索 11,780+ 种证券:股票、概念、板块、ETF、指数。
参数 | 类型 | 描述 |
| string | 搜索关键词 |
| string |
|
finance_search(keyword="芯片", type="etf") # Chip ETFs
finance_search(keyword="AI", type="concept") # AI concept indices
finance_search(keyword="沪深300", type="index") # CSI 300finance_exchange_rate — 汇率查询
finance_exchange_rate(from_currency="USD", to_currency="CNY")
finance_exchange_rate(from_currency="EUR", to_currency="JPY")finance_gold_price — 贵金属价格
finance_gold_price() # Gold, silver, platinum real-time prices信息 (5 个工具)
info_search — 网页搜索
参数 | 类型 | 描述 |
| string | 搜索关键词 |
| int | 结果数量 (1–50,默认 10) |
| string |
|
info_search(query="AI Agent trends 2026", count=20, recency="oneWeek")info_scrape — 网页抓取
info_scrape(url="https://example.com") # Returns clean markdowninfo_news — 新闻头条
参数 | 类型 | 描述 |
| string |
|
| int | 文章数量 (1–50) |
info_news(category="finance", limit=10)
info_news(category="tech")info_trending — 热搜榜
来自微博、抖音、知乎等平台的实时热搜榜。
info_trending()info_bulletin — 每日简报
info_bulletin() # Morning news digest生活服务 (7 个工具)
life_weather — 天气
参数 | 类型 | 描述 |
| string | 城市名称 (例如 |
| string | 经纬度 (例如 |
| bool | 是否包含 7 天预报 |
life_weather(city="北京", forecast=True)
life_weather(location="39.9,116.4")life_logistics — 物流追踪
life_logistics(number="SF1234567890") # Auto-detect carrier
life_logistics(number="1234567890", company="yt") # Specify carrierlife_ip — IP 地理位置
life_ip(address="8.8.8.8") # Country, city, timezone, ISP
life_ip() # Caller's IPlife_tax — 个税计算器
life_tax(monthly_salary=20000, insurance=2000, special_deduction=1500)life_calendar — 日历与交易日
life_calendar() # Today: lunar date, solar terms, holiday, trading day
life_calendar(date="2026-05-01") # Specific datelife_oil_price — 油价查询
life_oil_price() # National average
life_oil_price(province="北京") # Province-specificlife_traffic — 限行查询
life_traffic(city="北京") # Today's restricted plate numbersREST API
基础 URL: https://api.groundapi.net
所有接口均需 X-API-Key 请求头。
接口 | 描述 |
| 股票/指数/ETF 数据 |
| 市场概览 |
| 选股 |
| 证券搜索 |
| 汇率 |
| 黄金及贵金属 |
| 网页搜索 |
| 网页抓取 |
| 新闻头条 |
| 热搜榜 |
| 每日简报 |
| 天气 |
| 物流追踪 |
| IP 地理位置 |
| 个税计算器 |
| 日历信息 |
| 油价 |
| 限行查询 |
# 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 # Real-time 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
# Funds
groundapi fund # Fund ranking
groundapi fund --keyword 沪深300 # Search funds
groundapi fund --code 110011 # Fund details信息
groundapi search "AI Agent" # Web search
groundapi search "AI Agent" --count 20 --recency oneWeek # With filters
groundapi scrape https://example.com # Scrape webpage
groundapi news # Finance news
groundapi news --category tech --limit 10 # Tech news生活服务
groundapi weather --city 北京 # Current weather
groundapi weather --city 北京 --forecast # 7-day forecast
groundapi weather --location 39.9,116.4 # By coordinates
groundapi logistics SF1234567890 # Track package
groundapi ip 8.8.8.8 # IP lookupAgent 技能
预构建的技能,将 GroundAPI 工具组合为自动化工作流。可在 Cursor、OpenClaw 或 Smithery 中安装:
技能 | 描述 |
生成每日 A 股市场摘要 —— 指数、板块、热门股、异常情况 | |
13 个数据维度的深度分析 —— 输出包含技术面、财务面、资金流的结构化报告 | |
自然语言选股 —— “寻找高股息的低估值银行股” | |
多源研究 —— 搜索、抓取并综合信息 | |
位置感知的日常助手 —— 一次性获取天气、日历、交通、新闻 | |
市场异常检测 —— 异动成交量、价格缺口、连板分析 |
自托管 MCP 服务器
在本地运行 MCP 服务器 (使用 stdio 传输给本地 AI 客户端):
pip install -r requirements.txt
python mcp_server.py或连接到托管的 MCP 端点 (无需部署):
https://mcp.groundapi.net/mcp定价
免费版 | 付费版 | |
调用次数 | 500 次/月 | 按量付费 |
速率限制 | 60 次/分 | 300 次/分 |
支付方式 | — | 支付宝 / 微信支付 / 信用卡 |
在 groundapi.net 获取您的 API Key。
链接
官网: groundapi.net
API 文档: docs.groundapi.net
MCP 端点:
https://mcp.groundapi.net/mcpPyPI 上的 CLI: groundapi-cli
mcp.so: GroundAPI on mcp.so
许可
MIT — 仅限技能、MCP 服务器包装器和文档。GroundAPI 是商业 API 服务。
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseCqualityDmaintenanceThe MCP provides comprehensive financial data and analytical tool support for AI large language models, specifically including the following five core data capabilities: Stock Analysis/ETF Analysis/Public Funds/News & Information/General Tools More Info: https://github.com/shenqingtech/deepq-finan44407ISC
- AlicenseAqualityCmaintenanceProvides real-time stock market data and analysis from Chinese markets through 34 MCP tools, including K-line charts, technical indicators, fundamental analysis, financial metrics, and market insights without requiring authentication or API tokens.3453MIT
- AlicenseNot gradedqualityCmaintenanceReal-time A-share stock data for AI assistants. Provides real-time stock prices, K-line data, financial indicators, and sector fund flow analysis for Chinese A-share market. Multi-source data validation ensures accuracy.4MIT
- AlicenseNot gradedqualityCmaintenanceProvides 11 MCP tools for querying A-share market data, financial reports, stock screening, hot topics, self-selected stocks, and LOF arbitrage using natural language, powered by East Money / Miaoxiang APIs.MIT
Related MCP Connectors
Read-only China A-share data for AI agents: market, limit-up, capital flow and disclosures.
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
Access real-time and historical market data for China A-shares and Hong Kong stocks, along with ne…
Appeared in Searches
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/qingkongzhiqian/groundapi'
If you have feedback or need assistance with the MCP directory API, please join our Discord server