데이터를 바르게 유지하도록 도와주세요.

쓸 수 있는 데이터 세 가지

공식 개발자 경로. 어떤 호스트에 대해 운영 주체가 직접 공개한 API 문서나 개발자 포털이에요.

상태 페이지 매핑. 어떤 호스트에 대해 운영 주체가 직접 운영하는 상태 페이지와, 표준 피드가 있으면 그 주소예요.

이용 정보 묶음. 공식 경로를 쓰는 방법이에요: 인증 방식, 키를 받는 곳, 무료 사용량을 말하는 문장, 속도 제한·샌드박스·OpenAPI 파일·공식 MCP 서버 링크, 약관 페이지와 원문 짧은 인용 하나.

확인에 도움이 되는 것

그것을 본 공개 페이지 주소(운영 주체의 페이지)와, 대략 언제 보셨는지(UTC)를 알려 주세요. 이 둘이 있으면 우리가 그 페이지를 직접 다시 읽을 수 있고, 모든 항목은 그렇게 확인해요.

헷갈릴 만한 점이 있으면 짧은 메모도 환영해요. 예를 들어 두 페이지 중 어느 쪽이 최신인지 같은 거요.

예시 하나

가상의 호스트이고, 오프라인 번들 레코드와 같은 모양으로 한 줄에 JSON 객체 하나예요(여기서는 줄바꿈해서 보여 줘요).

{"schema_version": 1, "kind": "official_path",
 "observed_at": "2026-10-31T09:30:00Z",
 "source_url": "https://docs.example.com/api",
 "payload": {"site_host": "example.com", "name": "Example API",
             "api_docs": "https://docs.example.com/api",
             "developer_portal": null, "note": null},
 "credit": "a-handle-if-you-like"}

필드 설명은 contrib/README.md 에 있어요. credit 줄은 빼셔도 돼요.

받은 뒤 하는 일

우리가 공개 원본을 다시 직접 읽고, 맞는 것을 반영해요. 표의 나머지와 같은 큐레이션 기준을 따라요(운영 주체 소유 페이지, 원문 짧은 인용, 추측 없음). 확인하지 못한 것은 넣지 않고 이슈나 풀 리퀘스트에 이유를 적어요.

커밋이나 변경 기록에 이름을 남기고 싶으시면 어떻게 적을지 알려 주세요(핸들이어도 돼요). 아니면 이름은 적지 않아요. 풀 리퀘스트는 그대로 병합하지 않아요. 확인한 내용을 우리가 별도 변경으로 반영하고, 보내 주신 풀 리퀘스트는 감사 인사와 함께 닫아요. 그래서 커밋에 담긴 개인 정보가 프로젝트 본류 이력에 남지 않아요. 풀 리퀘스트 페이지에는 git 이 늘 그렇듯 작성자 이름이 보여요.

편한 쪽으로 보내세요

이슈 양식. 호스트, 종류, 근거 주소, 메모를 적는 짧은 양식이에요: 양식 열기.

풀 리퀘스트. 위 모양으로 contrib/ 아래에 JSON Lines 파일을 더해 주세요. python scripts/check_contrib.py 가 내 컴퓨터에서 모양을 검사하고 네트워크 요청은 보내지 않아요. 같은 검사가 CI 에서도 돌아요. 자세한 내용은 contrib/README.md 에 있어요.

에이전트라면. 에이전트 자신의 규칙이 공유를 허용한다면, MCP 도구 report_observation 으로 겪은 막힘이나 장애를 비식별 직접 관찰로 보낼 수 있어요. 이것은 위 표를 고치는 일과는 별개이고, 표를 고치는 길은 양식이나 풀 리퀘스트예요.