GroundAPI
Real-time Data API for AI Agents
GroundAPI provides a unified data layer for AI Agents β 10 tools covering A-share finance, web search, news, weather, logistics, and more. Supports REST API, MCP, and CLI.
π Website Β· π Documentation Β· π MCP Setup
Features
Finance (4 tools)
- Stock Data β Real-time A-share quotes, fundamentals, technicals, historical data
- Stock Screener β Multi-criteria screening with 20+ dimensions
- Market Overview β Indices, sector rotation, breadth, macro indicators
- Fund Data β Fund search, ranking, NAV, and manager info
Information (3 tools)
- Web Search β Multi-engine web search with recency filters
- Web Scraper β Extract clean markdown from any webpage
- News β Latest headlines by category (finance, tech, general, etc.)
Life Services (3 tools)
- Weather β Current conditions + 7-day forecast for any city
- Logistics β Track packages across major courier companies
- IP Geolocation β Country, city, timezone, ISP lookup
Quick Start
MCP (for AI Agents)
Add to your Claude Desktop, Cursor, Windsurf, or any MCP-compatible client:
{
"mcpServers": {
"groundapi": {
"url": "https://mcp.groundapi.net/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}
REST API
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.groundapi.net/v1/life/weather?city=Beijing"
CLI
pip install groundapi-cli
groundapi config set-key YOUR_API_KEY
groundapi stock 600519
groundapi weather Beijing
MCP Tools Reference
| Tool | Description | Example |
|---|---|---|
finance_stock | Query A-share stock data | finance_stock(symbol="600519") |
finance_stock_screen | Screen stocks by criteria | finance_stock_screen(industry="εε―Όδ½", pe_max=30) |
finance_market | Get market overview & sectors | finance_market(include="sectors,macro") |
finance_fund | Query fund data | finance_fund(keyword="ζ²ͺζ·±300") |
info_search | Search the web | info_search(query="AI trends 2026") |
info_scrape | Read a webpage as markdown | info_scrape(url="https://example.com") |
info_news | Get latest news | info_news(category="finance") |
life_weather | Get weather data | life_weather(city="Tokyo", forecast=true) |
life_logistics | Track a package | life_logistics(number="SF1234567890") |
life_ip | IP geolocation | life_ip(address="8.8.8.8") |
Pricing
- Free Tier: 500 calls/month
- Rate Limits: Free 60/min, Paid 300/min
- Payment: Alipay / WeChat Pay / Credit Card
Get your API key at groundapi.net.
Agent Skills
Pre-built skills for OpenClaw and Smithery that combine GroundAPI tools into ready-to-use workflows:
| Skill | Description |
|---|---|
| Market Briefing | Daily A-share market summary |
| A-Share Analyst | Individual stock analysis |
| Stock Screener | Smart stock screening |
| Web Researcher | Deep web research & synthesis |
| Context Aware | Location-aware daily assistant |
Links
- Website: groundapi.net
- API Docs: groundapi.net/documentation
- MCP Setup: Agent Integration Guide
- Smithery: smithery.ai
- CLI on PyPI: groundapi-cli
License
MIT β Skills and documentation only. GroundAPI is a commercial API service.