GroundAPI
GroundAPI는 AI 에이전트를 위한 통합 데이터 레이어를 제공합니다 — 금융, 정보, 생활 서비스 전반에 걸친 18개의 도구. 하나의 API 키로 REST API, MCP, CLI 등 세 가지 접근 방식을 지원합니다.
목차
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 600519MCP 도구 참조
금융 (6개 도구)
finance_stock — 증권 데이터
A주 주식, 지수, 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 | — | 날짜 필터 (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 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 — 실시간 트렌드
웨이보, 더우인, 지후 등 실시간 인기 검색어 순위.
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주 시장 요약 생성 — 지수, 섹터, 인기 주식, 이상 징후 | |
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 키를 받으세요.
링크
웹사이트: groundapi.net
API 문서: docs.groundapi.net
MCP 엔드포인트:
https://mcp.groundapi.net/mcpPyPI CLI: groundapi-cli
mcp.so: mcp.so의 GroundAPI
라이선스
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