Skip to main content
Glama

GroundAPIは、AIエージェントに統合データレイヤーを提供します。金融、情報、生活サービスにわたる18個のツールを搭載。1つのAPIキーで、REST APIMCPCLIの3つのアクセス方法が利用可能です。

License: MIT MCP PyPI

目次

Related MCP server: Real-time Stock MCP Service

クイックスタート

groundapi.netでAPIキーを取得してください。月間500コールまで無料、クレジットカード不要です。

オプション1: MCP (AIエージェントに推奨)

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株、指数、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

リアルタイム価格、PER/PBR、板情報(5段階)、ストップ高/安までの距離

"現在の価格は?"

kline

ローソク足データ (5/15/30/60分、日足、週足、月足対応)

"チャートを見せて"

technical

MACD、MA、BOLL、KDJ + シグナル検出 (例: "DIFがDEAをゴールデンクロス")

"テクニカル分析は?"

financial

3つの財務諸表、四半期損益、キャッシュフロー、配当、予測

"財務状況は?"

flow

資金フロー (大口/中口/小口注文)、連続流入/流出

"スマートマネーは買っている?"

holders

大株主トップ10、浮動株主、株主数推移、ファンド保有状況

"主要株主は誰?"

management

役員、取締役、監査役

"経営陣は誰?"

events

配当、増資、ロックアップ解除、決算カレンダー

"次の配当はいつ?"

tick

日中ティックデータと売買方向統計

"今日は買いと売りどちらが多い?"

summary

多次元的な事実集約 (意見なし)

"データサマリーを教えて"

peers

同業他社比較テーブル (PER/PBR/時価総額ランキング)

"業界内での順位は?"

# 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

日付フィルタ (YYYY-MM-DD)

範囲: 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

PER範囲

pb_max

float

最大PBR

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株市場のデイリーサマリーを生成 — 指数、セクター、注目銘柄、異常値

A-Share Analyst

13のデータディメンションによる詳細分析 — テクニカル、財務、資金フローを含む構造化レポートを出力

Stock Screener

自然言語による銘柄スクリーニング — "高配当で割安な銀行株を探して"

Web Researcher

マルチソースリサーチ — 検索、スクレイピング、情報統合

Context Aware

場所を意識したデイリーアシスタント — 天気、カレンダー、交通、ニュースを一度に取得

Anomaly Tracker

市場異常検知 — 異常な出来高、価格ギャップ、ストップ高連続記録


セルフホスト型MCPサーバー

MCPサーバーをローカルで実行 (ローカルAIクライアント用のstdioトランスポート):

pip install -r requirements.txt
python mcp_server.py

または、ホストされているMCPエンドポイントに接続 (デプロイ不要):

https://mcp.groundapi.net/mcp

料金

無料

有料

コール数

月間500回

従量課金

レート制限

60回/分

300回/分

支払い

Alipay / WeChat Pay / クレジットカード

groundapi.netでAPIキーを取得してください。

リンク

ライセンス

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