Skip to main content
Glama

GroundAPI предоставляет унифицированный уровень данных для ИИ-агентов — 18 инструментов в сферах финансов, информации и бытовых услуг. Один API-ключ, три способа доступа: REST API, MCP и CLI.

License: MIT MCP PyPI

Оглавление

Related MCP server: Real-time Stock MCP Service

Быстрый старт

Получите свой API-ключ на groundapi.net500 бесплатных вызовов в месяц, кредитная карта не требуется.

Вариант 1: MCP (рекомендуется для ИИ-агентов)

Добавьте в 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

Финансы (6 инструментов)

finance_stock — Данные по ценным бумагам

Универсальный запрос для акций A-share, индексов и ETF. Поддерживает 13 измерений данных и сравнение нескольких акций.

Параметр

Тип

По умолчанию

Описание

symbol

string

Код акции. Через запятую для сравнения (например, "600519,000858")

keyword

string

Поиск по названию (например, "茅台")

aspects

string

"overview"

Измерения данных через запятую (см. таблицу ниже)

days

int

60

Исторический диапазон для графиков/технических данных

period

string

"d"

Период графика: 5/15/30/60/d/w/m

13 доступных аспектов:

Аспект

Возвращает

Использовать, когда

overview

Краткий обзор: котировка + профиль + финансовая сводка

"Как дела у XXXX?"

profile

Полная информация о компании, концепции, индексы, структура капитала

"Чем занимается эта компания?"

quote

Цена в реальном времени, PE/PB, стакан 5 уровней, лимиты роста/падения

"Текущая цена?"

kline

Данные графика (поддерживает 5/15/30/60мин, дневные, недельные, месячные)

"Покажи график"

technical

MACD, MA, BOLL, KDJ + сигналы (например, "DIF пересекает DEA снизу вверх")

"Технический анализ?"

financial

3 финансовых отчета, квартальная прибыль/убытки, денежные потоки, дивиденды, прогнозы

"Как финансовые показатели?"

flow

Потоки капитала (крупные/средние/мелкие ордера), последовательный приток/отток

"Умные деньги покупают?"

holders

Топ-10 акционеров, держатели акций в свободном обращении, тренды, владения фондов

"Кто основные акционеры?"

management

Руководители, члены совета директоров, наблюдатели

"Кто в руководстве?"

events

Дивиденды, выпуск акций, истечение периода блокировки, календарь отчетности

"Когда следующие дивиденды?"

tick

Внутридневные тиковые данные со статистикой направления покупки/продажи

"Сегодня больше покупателей или продавцов?"

summary

Многомерная фактическая агрегация (без мнений)

"Дай полную сводку данных"

peers

Сравнительная таблица по отрасли с рейтингом 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 ETF

finance_market — Обзор рынка

Рыночные данные: основные индексы, популярные акции, ротация секторов, календарь IPO, сигналы аномалий.

Параметр

Тип

По умолчанию

Описание

scope

string

"overview"

Область данных через запятую

sector

string

Детальный анализ конкретного сектора

date

string

Фильтр по дате (ГГГГ-ММ-ДД)

Области: 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+ измерениями и предустановленными комбинациями фильтров.

Параметр

Тип

Описание

industry

string

Фильтр по отрасли (например, "银行", "半导体")

concept

string

Фильтр по концепции (например, "AI", "新能源")

pe_max / pe_min

float

Диапазон коэффициента PE

pb_max

float

Максимальный коэффициент PB

min_market_cap / max_market_cap

float

Диапазон рыночной капитализации

min_dividend_yield

float

Минимальная дивидендная доходность (%)

filter_preset

string

low_pe_high_div · small_cap_growth · large_cap_stable

sort_by

string

Поле для сортировки (по умолчанию: 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

Поиск по более чем 11 780 ценным бумагам: акции, концепции, сектора, ETF, индексы.

Параметр

Тип

Описание

keyword

string

Поисковый запрос

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 — Валютные курсы

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 инструментов)

Параметр

Тип

Описание

query

string

Поисковые ключевые слова

count

int

Количество результатов (1–50, по умолчанию 10)

recency

string

noLimit · oneDay · oneWeek · oneMonth · oneYear

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

info_scrape — Веб-скрейпер

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

info_news — Заголовки новостей

Параметр

Тип

Описание

category

string

finance · general · tech · sports ...

limit

int

Количество статей (1–50)

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

Рейтинги горячих поисковых запросов в реальном времени из Weibo, Douyin, Zhihu и других источников.

info_trending()

info_bulletin — Ежедневная сводка

info_bulletin()   # Morning news digest

Бытовые услуги (7 инструментов)

life_weather — Погода

Параметр

Тип

Описание

city

string

Название города (например, "Beijing")

location

string

Широта,долгота (например, "39.9,116.4")

forecast

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 carrier

life_ip — IP-геолокация

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

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

life_oil_price — Цены на топливо

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

life_traffic — Ограничения движения

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

REST API

Базовый URL: https://api.groundapi.net

Все эндпоинты требуют заголовок X-API-Key.

Эндпоинт

Описание

GET /v1/finance/stock

Данные акций/индексов/ETF

GET /v1/finance/market

Обзор рынка

GET /v1/finance/stock/screen

Скрининг акций

GET /v1/finance/search

Поиск ценных бумаг

GET /v1/finance/exchange-rate

Валютные курсы

GET /v1/finance/gold-price

Золото и драгметаллы

GET /v1/info/search

Веб-поиск

GET /v1/info/scrape

Веб-скрейпинг

GET /v1/info/news

Заголовки новостей

GET /v1/info/trending

Трендовые темы

GET /v1/info/bulletin

Ежедневная сводка

GET /v1/life/weather

Погода

GET /v1/life/logistics

Отслеживание посылок

GET /v1/life/ip

IP-геолокация

GET /v1/life/tax

Налоговый калькулятор

GET /v1/life/calendar

Информация календаря

GET /v1/life/oil-price

Цены на топливо

GET /v1/life/traffic

Ограничения движения

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

Навыки агентов

Готовые навыки, объединяющие инструменты GroundAPI в автоматизированные рабочие процессы. Установите в Cursor, OpenClaw или Smithery:

Навык

Описание

Market Briefing

Генерирует ежедневную сводку рынка A-share — индексы, сектора, популярные акции, аномалии

A-Share Analyst

Глубокий анализ по 13 измерениям — выдает структурированный отчет с техническими и финансовыми данными

Stock Screener

Скрининг акций на естественном языке — "найди недооцененные банковские акции с высокими дивидендами"

Web Researcher

Исследование из нескольких источников — поиск, скрейпинг и синтез информации

Context Aware

Контекстный ежедневный помощник — погода, календарь, трафик, новости в одном запросе

Anomaly Tracker

Детектирование рыночных аномалий — необычный объем, ценовые разрывы, серии лимитов роста


Self-hosted MCP сервер

Запустите MCP сервер локально (транспорт stdio для локальных ИИ-клиентов):

pip install -r requirements.txt
python mcp_server.py

Или подключитесь к хостинговому MCP эндпоинту (развертывание не требуется):

https://mcp.groundapi.net/mcp

Цены

Бесплатно

Платно

Вызовы

500/мес

Оплата по факту

Лимит запросов

60/мин

300/мин

Оплата

Alipay / WeChat Pay / Кредитная карта

Получите свой API-ключ на groundapi.net.

Ссылки

Лицензия

MIT — только для навыков, обертки MCP сервера и документации. GroundAPI является коммерческим API-сервисом.

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