Skip to main content
Glama

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.

License: MIT MCP PyPI

Tabla de contenidos

Related MCP server: Real-time Stock MCP Service

Inicio rápido

Obtenga su clave API en groundapi.net500 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 600519

Referencia 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

symbol

string

Código de acción. Separado por comas para comparación (ej. "600519,000858")

keyword

string

Búsqueda por nombre (ej. "茅台")

aspects

string

"overview"

Dimensiones de datos, separadas por comas (ver tabla abajo)

days

int

60

Rango histórico para kline/técnico

period

string

"d"

Periodo de línea K: 5/15/30/60/d/w/m

13 aspectos disponibles:

Aspecto

Devuelve

Usar cuando

overview

Instantánea rápida: cotización + perfil breve + resumen financiero

"¿Cómo va XXXX?"

profile

Información completa de la empresa, conceptos, pertenencia a índices, estructura de capital

"¿Qué hace esta empresa?"

quote

Precio en tiempo real, PE/PB, oferta/demanda de 5 niveles, distancia límite superior/inferior

"¿Precio actual?"

kline

Datos de línea K (admite 5/15/30/60min, diario, semanal, mensual)

"Muéstrame el gráfico"

technical

MACD, MA, BOLL, KDJ + detección de señales (ej. "DIF cruza por encima de DEA")

"¿Análisis técnico?"

financial

3 estados financieros, P&L trimestral, flujo de caja, dividendos, previsiones

"¿Cómo están las finanzas?"

flow

Flujo de capital (órdenes mega/grandes/medianas/pequeñas), entrada/salida consecutiva

"¿Está comprando el dinero inteligente?"

holders

10 principales accionistas, accionistas flotantes, tendencia de conteo, tenencias de fondos

"¿Quiénes son los principales accionistas?"

management

Ejecutivos, directores de junta, supervisores

"¿Quién es la dirección?"

events

Dividendos, emisión de acciones, vencimiento de bloqueo, calendario de ganancias

"¿Cuándo es el próximo dividendo?"

tick

Tick-a-tick intradía con estadísticas de dirección de compra/venta

"¿Más compradores o vendedores hoy?"

summary

Agregación factual multidimensional (sin opiniones)

"Dame un resumen completo de datos"

peers

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 ETF

finance_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

scope

string

"overview"

Alcance de datos, separado por comas

sector

string

Profundizar en un sector específico

date

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 calendar

finance_screen — Filtro de acciones

Filtrado multicriterio con más de 20 dimensiones y combinaciones de filtros preestablecidas.

Parámetro

Tipo

Descripción

industry

string

Filtro de industria (ej. "银行", "半导体")

concept

string

Filtro de concepto (ej. "AI", "新能源")

pe_max / pe_min

float

Rango de ratio PE

pb_max

float

Ratio PB máximo

min_market_cap / max_market_cap

float

Rango de capitalización de mercado

min_dividend_yield

float

Rendimiento mínimo por dividendo (%)

filter_preset

string

low_pe_high_div · small_cap_growth · large_cap_stable

sort_by

string

Campo de ordenación (predeterminado: change_pct)

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

Búsqueda en más de 11,780 valores: acciones, conceptos, sectores, ETFs, índices.

Parámetro

Tipo

Descripción

keyword

string

Consulta de búsqueda

type

string

all · stock (6,104) · concept (2,222) · sector (1,466) · etf (1,377) · index (613)

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_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 prices

Información (5 herramientas)

Parámetro

Tipo

Descripción

query

string

Palabras clave de búsqueda

count

int

Número de resultados (1–50, predeterminado 10)

recency

string

noLimit · oneDay · oneWeek · oneMonth · oneYear

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

info_scrape — Web Scraper

info_scrape(url="https://example.com")   # Returns clean markdown

info_news — Titulares de noticias

Parámetro

Tipo

Descripción

category

string

finance · general · tech · sports ...

limit

int

Número de artículos (1–50)

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

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 digest

Servicios de vida (7 herramientas)

life_weather — Clima

Parámetro

Tipo

Descripción

city

string

Nombre de la ciudad (ej. "Beijing")

location

string

Lat,lng (ej. "39.9,116.4")

forecast

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 carrier

life_ip — Geolocalización IP

life_ip(address="8.8.8.8")   # Country, city, timezone, ISP
life_ip()                     # Caller's IP

life_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 date

life_oil_price — Precios del combustible

life_oil_price()                  # National average
life_oil_price(province="北京")   # Province-specific

life_traffic — Restricciones de conducción

life_traffic(city="北京")   # Today's restricted plate numbers

REST API

URL base: https://api.groundapi.net

Todos los endpoints requieren el encabezado X-API-Key.

Endpoint

Descripción

GET /v1/finance/stock

Datos de acciones/índices/ETF

GET /v1/finance/market

Visión general del mercado

GET /v1/finance/stock/screen

Filtrado de acciones

GET /v1/finance/search

Búsqueda de valores

GET /v1/finance/exchange-rate

Tipos de cambio

GET /v1/finance/gold-price

Oro y metales preciosos

GET /v1/info/search

Búsqueda web

GET /v1/info/scrape

Web scraping

GET /v1/info/news

Titulares de noticias

GET /v1/info/trending

Temas de tendencia

GET /v1/info/bulletin

Resumen diario

GET /v1/life/weather

Clima

GET /v1/life/logistics

Seguimiento de paquetes

GET /v1/life/ip

Geolocalización IP

GET /v1/life/tax

Calculadora de impuestos

GET /v1/life/calendar

Información del calendario

GET /v1/life/oil-price

Precios del combustible

GET /v1/life/traffic

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_KEY

Finanzas

# 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

Informació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 news

Servicios 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 lookup

Habilidades de agente

Habilidades preconstruidas que combinan herramientas de GroundAPI en flujos de trabajo automatizados. Instalar en Cursor, OpenClaw o Smithery:

Habilidad

Descripción

Resumen de mercado

Genera un resumen diario del mercado A-share: índices, sectores, acciones calientes, anomalías

Analista A-Share

Análisis profundo con 13 dimensiones de datos: genera un informe estructurado con aspectos técnicos, financieros y flujo de capital

Filtro de acciones

Filtrado de acciones en lenguaje natural: "encontrar acciones bancarias infravaloradas con altos dividendos"

Investigador web

Investigación de múltiples fuentes: busca, extrae y sintetiza información

Consciente del contexto

Asistente diario consciente de la ubicación: clima, calendario, tráfico, noticias en una sola toma

Rastreador de anomalías

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.py

O conéctese al endpoint MCP alojado (no se requiere implementación):

https://mcp.groundapi.net/mcp

Precios

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

Licencia

MIT: solo habilidades, contenedor de servidor MCP y documentación. GroundAPI es un servicio de API comercial.

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

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

  • A
    license
    C
    quality
    D
    maintenance
    The 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-finan
    44
    40
    7
    ISC
  • A
    license
    A
    quality
    C
    maintenance
    Provides 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.
    34
    53
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Real-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.
    4
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides 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

View all related MCP servers

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…

View all MCP Connectors

Appeared in Searches

Latest Blog Posts

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