Skip to main content
Glama

GroundAPI는 AI 에이전트를 위한 통합 데이터 레이어를 제공합니다 — 금융, 정보, 생활 서비스 전반에 걸친 18개의 도구. 하나의 API 키로 REST API, MCP, CLI 등 세 가지 접근 방식을 지원합니다.

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

실시간 가격, 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

날짜 필터 (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

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")

웨이보, 더우인, 지후 등 실시간 인기 검색어 순위.

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에 설치하세요:

스킬

설명

시장 브리핑

일일 A주 시장 요약 생성 — 지수, 섹터, 인기 주식, 이상 징후

A주 분석가

13가지 데이터 차원을 활용한 심층 분석 — 기술적, 재무적, 자본 흐름 보고서 출력

주식 스크리너

자연어 주식 스크리닝 — "배당 높은 저평가 은행주 찾아줘"

웹 연구원

다중 소스 연구 — 정보 검색, 스크래핑 및 종합

상황 인식

위치 기반 일일 비서 — 날씨, 달력, 교통, 뉴스 한 번에 확인

이상 징후 추적기

시장 이상 징후 감지 — 비정상 거래량, 가격 갭, 상한가 연속 기록


자체 호스팅 MCP 서버

로컬에서 MCP 서버를 실행하세요 (로컬 AI 클라이언트를 위한 stdio 전송):

pip install -r requirements.txt
python mcp_server.py

또는 호스팅된 MCP 엔드포인트에 연결하세요 (배포 불필요):

https://mcp.groundapi.net/mcp

가격

무료

유료

호출

월 500회

종량제

속도 제한

분당 60회

분당 300회

결제

알리페이 / 위챗페이 / 신용카드

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