aiSwingX™
로그인
KO ▾
EN English KO 한국어 ✓

API · MCP 사용 가이드

aiSwingX™ 는 미국 공시를 분석해 투자자가 이해할 수 있는 기사로 전하는 뉴스 서비스입니다.
–
33 1

글은 세 가지 방법으로 가져갈 수 있습니다. 무료 글은 키 없이, 유료 글 전문과 종목별 숫자는 구독자 키로 열립니다. 키는 내 계정 → API · MCP에서 발급·확인합니다.

1. MCP — AI 어시스턴트에 연결

Claude·ChatGPT·Cursor 같은 도구가 이 사이트의 글을 직접 읽고 인용하게 하는 방법입니다.

서버주소인증내용
무료https://aiswingx.com/mcp없음무료 글 전문, 유료 글은 네 줄 요약
Prohttps://aiswingx.com/mcp/proAuthorization: Bearer asx_…유료 글 전문 + 종목별 분기 숫자

Claude (claude.ai · Claude Desktop)

설정 → 커넥터(Connectors) → "커스텀 커넥터 추가" → URL 에 https://aiswingx.com/mcp/pro, 헤더에 Authorization: Bearer asx_…. 그 뒤 대화에서 "SOFI 최신 글 찾아줘"처럼 물으면 됩니다.

Claude Code · Cursor · 기타 (JSON 설정)

{
  "mcpServers": {
    "aiswingx": {
      "url": "https://aiswingx.com/mcp/pro",
      "headers": { "Authorization": "Bearer asx_여기에_키" }
    }
  }
}

ChatGPT (개발자 모드 · 커스텀 GPT)

설정 → 커넥터 → MCP 서버 추가 → URL https://aiswingx.com/mcp (무료) 또는 /mcp/pro + 헤더.

제공 도구

2. REST API

GET https://aiswingx.com/api/v1                      # 안내
GET https://aiswingx.com/api/v1/posts?ticker=SOFI    # 목록
GET https://aiswingx.com/api/v1/posts/sofi-2026q2    # 글 하나
GET https://aiswingx.com/api/v1/search?q=공정가치
GET https://aiswingx.com/api/v1/tickers
GET https://aiswingx.com/api/v1/metrics/SOFI         # 구독자 키

Authorization: Bearer asx_여기에_키

응답은 JSON. 글에는 four_lines(숫자·비유·출처·다음 분기), body_md, faq, metrics, url 이 들어 있습니다.

curl 예시

curl -H "Authorization: Bearer asx_…" "https://aiswingx.com/api/v1/posts/sofi-2026q2"

Python 예시

import requests
r = requests.get("https://aiswingx.com/api/v1/posts", params={"ticker": "SOFI"},
                 headers={"Authorization": "Bearer asx_…"})
for p in r.json()["items"]:
    print(p["ticker"], p["quarter"], p["four_lines"]["number"], p["url"])

3. RSS · 텍스트

한도 · 규칙

자주 묻는 질문

API 키는 어디에서 발급받나요?

유료 구독이 활성화되면 결제 완료 화면에서 자동으로 발급되며, 계정 → API·MCP 메뉴에서 확인·재발급·폐기하실 수 있습니다.

MCP 는 무엇인가요?

Claude, ChatGPT 등 AI 어시스턴트가 외부 서비스의 자료를 직접 읽을 수 있게 하는 표준 연결 방식입니다. 이 서버를 연결하면 어시스턴트가 aiSwingX™ 기사를 검색하고 인용합니다.

호출 한도를 넘기면 어떻게 되나요?

429 응답이 반환되며, 다음 날 한도가 초기화됩니다. 더 높은 한도가 필요하시면 라이선스 플랜을 이용하시거나 문의해 주시기 바랍니다.

기사를 다시 게재할 때 지켜야 할 것은 무엇인가요?

기사 URL 과 공시 출처를 함께 표기해 주시기 바랍니다. 재배포는 라이선스 플랜에서만 허용되며, 숫자와 출처 표기는 변경하실 수 없습니다.

aiSwingX™ 는 미국 공시를 분석해 투자자가 이해할 수 있는 기사로 전하는 뉴스 서비스입니다.
–
33 1