GroundAPI
GroundAPI proporciona una capa de datos unificada para agentes de IA: 18 herramientas que abarcan finanzas, información y servicios de vida. Una clave API, tres métodos de acceso: REST API, MCP y CLI.
Tabla de contenidos
Related MCP server: Real-time Stock MCP Service
Inicio rápido
Obtenga su clave API en groundapi.net — 500 llamadas gratuitas/mes, no se requiere tarjeta de crédito.
Opción 1: MCP (recomendado para agentes de IA)
Añadir a Claude Desktop, Cursor, Windsurf o cualquier cliente compatible con MCP:
{
"mcpServers": {
"groundapi": {
"url": "https://mcp.groundapi.net/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}Opción 2: REST API
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.groundapi.net/v1/finance/stock?symbol=600519&aspects=overview"Opción 3: CLI
pip install groundapi-cli
groundapi config set-key YOUR_API_KEY
groundapi stock --symbol 600519Referencia de herramientas MCP
Finanzas (6 herramientas)
finance_stock — Datos de valores
Consulta todo en uno para acciones A-share, índices y ETFs. Admite 13 dimensiones de datos y comparación de múltiples acciones.
Parámetro | Tipo | Predeterminado | Descripción |
| string | — | Código de acción. Separado por comas para comparación (ej. |
| string | — | Búsqueda por nombre (ej. |
| string |
| Dimensiones de datos, separadas por comas (ver tabla abajo) |
| int |
| Rango histórico para kline/técnico |
| string |
| Periodo de línea K: |
13 aspectos disponibles:
Aspecto | Devuelve | Usar cuando |
| Instantánea rápida: cotización + perfil breve + resumen financiero | "¿Cómo va XXXX?" |
| Información completa de la empresa, conceptos, pertenencia a índices, estructura de capital | "¿Qué hace esta empresa?" |
| Precio en tiempo real, PE/PB, oferta/demanda de 5 niveles, distancia límite superior/inferior | "¿Precio actual?" |
| Datos de línea K (admite 5/15/30/60min, diario, semanal, mensual) | "Muéstrame el gráfico" |
| MACD, MA, BOLL, KDJ + detección de señales (ej. "DIF cruza por encima de DEA") | "¿Análisis técnico?" |
| 3 estados financieros, P&L trimestral, flujo de caja, dividendos, previsiones | "¿Cómo están las finanzas?" |
| Flujo de capital (órdenes mega/grandes/medianas/pequeñas), entrada/salida consecutiva | "¿Está comprando el dinero inteligente?" |
| 10 principales accionistas, accionistas flotantes, tendencia de conteo, tenencias de fondos | "¿Quiénes son los principales accionistas?" |
| Ejecutivos, directores de junta, supervisores | "¿Quién es la dirección?" |
| Dividendos, emisión de acciones, vencimiento de bloqueo, calendario de ganancias | "¿Cuándo es el próximo dividendo?" |
| Tick-a-tick intradía con estadísticas de dirección de compra/venta | "¿Más compradores o vendedores hoy?" |
| Agregación factual multidimensional (sin opiniones) | "Dame un resumen completo de datos" |
| Tabla de comparación de la misma industria con ranking de PE/PB/capitalización de mercado | "¿Cómo se clasifica en el sector?" |
# 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 — Visión general del mercado
Datos de todo el mercado: índices principales, acciones calientes, rotación sectorial, calendario de OPI, señales de anomalía.
Parámetro | Tipo | Predeterminado | Descripción |
| string |
| Alcance de datos, separado por comas |
| string | — | Profundizar en un sector específico |
| string | — | Filtro de fecha (YYYY-MM-DD) |
Alcances: overview (índices + sentimiento) · hot (pools de límite superior/inferior, desglose de rachas) · sectors (listas de conceptos e industrias) · ipo (calendario de OPI) · signals (detección de anomalías)
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 — Filtro de acciones
Filtrado multicriterio con más de 20 dimensiones y combinaciones de filtros preestablecidas.
Parámetro | Tipo | Descripción |
| string | Filtro de industria (ej. |
| string | Filtro de concepto (ej. |
| float | Rango de ratio PE |
| float | Ratio PB máximo |
| float | Rango de capitalización de mercado |
| float | Rendimiento mínimo por dividendo (%) |
| string |
|
| string | Campo de ordenación (predeterminado: |
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 — Búsqueda universal
Búsqueda en más de 11,780 valores: acciones, conceptos, sectores, ETFs, índices.
Parámetro | Tipo | Descripción |
| string | Consulta de búsqueda |
| 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 — Cambio de divisas
finance_exchange_rate(from_currency="USD", to_currency="CNY")
finance_exchange_rate(from_currency="EUR", to_currency="JPY")finance_gold_price — Metales preciosos
finance_gold_price() # Gold, silver, platinum real-time pricesInformación (5 herramientas)
info_search — Búsqueda web
Parámetro | Tipo | Descripción |
| string | Palabras clave de búsqueda |
| int | Número de resultados (1–50, predeterminado 10) |
| string |
|
info_search(query="AI Agent trends 2026", count=20, recency="oneWeek")info_scrape — Web Scraper
info_scrape(url="https://example.com") # Returns clean markdowninfo_news — Titulares de noticias
Parámetro | Tipo | Descripción |
| string |
|
| int | Número de artículos (1–50) |
info_news(category="finance", limit=10)
info_news(category="tech")info_trending — Temas de tendencia
Rankings de búsqueda caliente en tiempo real de Weibo, Douyin, Zhihu y más.
info_trending()info_bulletin — Resumen diario
info_bulletin() # Morning news digestServicios de vida (7 herramientas)
life_weather — Clima
Parámetro | Tipo | Descripción |
| string | Nombre de la ciudad (ej. |
| string | Lat,lng (ej. |
| bool | Incluir pronóstico de 7 días |
life_weather(city="北京", forecast=True)
life_weather(location="39.9,116.4")life_logistics — Seguimiento de paquetes
life_logistics(number="SF1234567890") # Auto-detect carrier
life_logistics(number="1234567890", company="yt") # Specify carrierlife_ip — Geolocalización IP
life_ip(address="8.8.8.8") # Country, city, timezone, ISP
life_ip() # Caller's IPlife_tax — Calculadora de impuestos sobre la renta
life_tax(monthly_salary=20000, insurance=2000, special_deduction=1500)life_calendar — Calendario y días de negociación
life_calendar() # Today: lunar date, solar terms, holiday, trading day
life_calendar(date="2026-05-01") # Specific datelife_oil_price — Precios del combustible
life_oil_price() # National average
life_oil_price(province="北京") # Province-specificlife_traffic — Restricciones de conducción
life_traffic(city="北京") # Today's restricted plate numbersREST API
URL base: https://api.groundapi.net
Todos los endpoints requieren el encabezado X-API-Key.
Endpoint | Descripción |
| Datos de acciones/índices/ETF |
| Visión general del mercado |
| Filtrado de acciones |
| Búsqueda de valores |
| Tipos de cambio |
| Oro y metales preciosos |
| Búsqueda web |
| Web scraping |
| Titulares de noticias |
| Temas de tendencia |
| Resumen diario |
| Clima |
| Seguimiento de paquetes |
| Geolocalización IP |
| Calculadora de impuestos |
| Información del calendario |
| Precios del combustible |
| Restricciones de conducción |
# 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"Documentación completa de la API: docs.groundapi.net
Referencia de CLI
Instalación
pip install groundapi-cli
groundapi config set-key YOUR_API_KEYFinanzas
# 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 detailsInformación
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 newsServicios de vida
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 lookupHabilidades de agente
Habilidades preconstruidas que combinan herramientas de GroundAPI en flujos de trabajo automatizados. Instalar en Cursor, OpenClaw o Smithery:
Habilidad | Descripción |
Genera un resumen diario del mercado A-share: índices, sectores, acciones calientes, anomalías | |
Análisis profundo con 13 dimensiones de datos: genera un informe estructurado con aspectos técnicos, financieros y flujo de capital | |
Filtrado de acciones en lenguaje natural: "encontrar acciones bancarias infravaloradas con altos dividendos" | |
Investigación de múltiples fuentes: busca, extrae y sintetiza información | |
Asistente diario consciente de la ubicación: clima, calendario, tráfico, noticias en una sola toma | |
Detección de anomalías de mercado: volumen inusual, brechas de precios, rachas de límite superior |
Servidor MCP autohospedado
Ejecute el servidor MCP localmente (transporte stdio para clientes de IA locales):
pip install -r requirements.txt
python mcp_server.pyO conéctese al endpoint MCP alojado (no se requiere implementación):
https://mcp.groundapi.net/mcpPrecios
Gratis | Pago | |
Llamadas | 500/mes | Pago por uso |
Límite de tasa | 60/min | 300/min |
Pago | — | Alipay / WeChat Pay / Tarjeta de crédito |
Obtenga su clave API en groundapi.net.
Enlaces
Sitio web: groundapi.net
Documentación de API: docs.groundapi.net
Endpoint MCP:
https://mcp.groundapi.net/mcpCLI en PyPI: groundapi-cli
mcp.so: GroundAPI en mcp.so
Licencia
MIT: solo habilidades, contenedor de servidor MCP y documentación. GroundAPI es un servicio de API comercial.
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