S위키 데이터를 프로그램으로 읽는 오픈 API

절차

1. 약관 동의

   이용약관 전문을 읽고 필수 조항 하나하나에 동의합니다. 특히 중단·변경·유료화 조항입니다.

2. 신청

   이름·소속·이메일·용도·예상 요청량을 적어 신청합니다. 신청 번호와 토큰이 한 번 표시됩니다.

3. 승인 대기

   편집국이 용도와 요청량을 보고 승인·거절합니다. 결과는 이메일로 알립니다.

4. 키 수령·사용

   상태 페이지에서 토큰으로 API 키를 한 번 받습니다. 잃어버리면 회전으로 새 키를 받습니다.

AI 에이전트(MCP)로 전 과정 진행하기

사람이 폼을 채우지 않아도 됩니다. 뉴스S 원격 MCP 서버를 붙이면 에이전트가 약관을 읽고, 의뢰인의 동의를 받아 신청하고, 승인 뒤 키를 받아 바로 조회까지 합니다. 도구 순서는 openapi_guide → openapi_terms → openapi_apply → openapi_status 입니다.

claude mcp add --transport http news-s https://news-s.kr/mcp

{
  "mcpServers": {
    "news-s": { "type": "http", "url": "https://news-s.kr/mcp" }
  }
}

승인된 키를 Authorization: Bearer nsw_live_… 로 보내면 openapi_search_people, openapi_person, openapi_org 도구로 S위키를 조회합니다.

HTTP 로 쓰기

승인된 키는 X-Api-Key 헤더 또는 Authorization: Bearer 로 보냅니다. 응답은 한 봉투로 고정돼 있고 변경은 문서의 변경 로그로만 합니다. 자세한 필드는 API 문서에 있습니다.

curl -s -H 'X-Api-Key: nsw_live_…' \
  'https://news-s.kr/api/v1/people?q=정명근&limit=5'

curl -s -H 'X-Api-Key: nsw_live_…' \
  'https://news-s.kr/api/v1/people/정명근·화성특례시'

{ "ok": false, "error": "승인된 API 키가 필요합니다. https://news-s.kr/openapi 에서 신청하세요.",
  "data": { "apply": "/api/v1/apply", "terms": "/api/v1/terms" } }

한도와 조건