GroundAPI
GroundAPI предоставляет унифицированный уровень данных для ИИ-агентов — 18 инструментов в сферах финансов, информации и бытовых услуг. Один API-ключ, три способа доступа: REST API, MCP и CLI.
Оглавление
Related MCP server: Real-time Stock MCP Service
Быстрый старт
Получите свой API-ключ на groundapi.net — 500 бесплатных вызовов в месяц, кредитная карта не требуется.
Вариант 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 измерений данных и сравнение нескольких акций.
Параметр | Тип | По умолчанию | Описание |
| string | — | Код акции. Через запятую для сравнения (например, |
| string | — | Поиск по названию (например, |
| string |
| Измерения данных через запятую (см. таблицу ниже) |
| int |
| Исторический диапазон для графиков/технических данных |
| string |
| Период графика: |
13 доступных аспектов:
Аспект | Возвращает | Использовать, когда |
| Краткий обзор: котировка + профиль + финансовая сводка | "Как дела у XXXX?" |
| Полная информация о компании, концепции, индексы, структура капитала | "Чем занимается эта компания?" |
| Цена в реальном времени, PE/PB, стакан 5 уровней, лимиты роста/падения | "Текущая цена?" |
| Данные графика (поддерживает 5/15/30/60мин, дневные, недельные, месячные) | "Покажи график" |
| MACD, MA, BOLL, KDJ + сигналы (например, "DIF пересекает DEA снизу вверх") | "Технический анализ?" |
| 3 финансовых отчета, квартальная прибыль/убытки, денежные потоки, дивиденды, прогнозы | "Как финансовые показатели?" |
| Потоки капитала (крупные/средние/мелкие ордера), последовательный приток/отток | "Умные деньги покупают?" |
| Топ-10 акционеров, держатели акций в свободном обращении, тренды, владения фондов | "Кто основные акционеры?" |
| Руководители, члены совета директоров, наблюдатели | "Кто в руководстве?" |
| Дивиденды, выпуск акций, истечение периода блокировки, календарь отчетности | "Когда следующие дивиденды?" |
| Внутридневные тиковые данные со статистикой направления покупки/продажи | "Сегодня больше покупателей или продавцов?" |
| Многомерная фактическая агрегация (без мнений) | "Дай полную сводку данных" |
| Сравнительная таблица по отрасли с рейтингом 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 | — | Фильтр по дате (ГГГГ-ММ-ДД) |
Области: 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 | Диапазон коэффициента PE |
| float | Максимальный коэффициент PB |
| 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 — Трендовые темы
Рейтинги горячих поисковых запросов в реальном времени из Weibo, Douyin, Zhihu и других источников.
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 lookupНавыки агентов
Готовые навыки, объединяющие инструменты GroundAPI в автоматизированные рабочие процессы. Установите в Cursor, OpenClaw или Smithery:
Навык | Описание |
Генерирует ежедневную сводку рынка A-share — индексы, сектора, популярные акции, аномалии | |
Глубокий анализ по 13 измерениям — выдает структурированный отчет с техническими и финансовыми данными | |
Скрининг акций на естественном языке — "найди недооцененные банковские акции с высокими дивидендами" | |
Исследование из нескольких источников — поиск, скрейпинг и синтез информации | |
Контекстный ежедневный помощник — погода, календарь, трафик, новости в одном запросе | |
Детектирование рыночных аномалий — необычный объем, ценовые разрывы, серии лимитов роста |
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.
Ссылки
Веб-сайт: groundapi.net
Документация API: docs.groundapi.net
MCP Endpoint:
https://mcp.groundapi.net/mcpCLI на PyPI: groundapi-cli
mcp.so: GroundAPI на 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