CiteWire

citewire.org · Openly Useful

출처 우선(attribution-first) 방식의 뉴스 및 리서치 발견을 위한 MCP 인프라입니다.

CiteWire는 에이전트에게 뉴스와 리서치 메타데이터에 대한 구조화된 읽기 전용 접근을 제공하면서, 원본 게시자의 출처(크레딧)와 트래픽을 보존합니다. 호환되는 뉴스 플랫폼을 타입이 지정된 MCP 도구로 노출하거나, 선택적인 공개 공급자 API를 쿼리하거나, 하나의 서버에서 두 가지를 모두 처리할 수 있습니다.

Community 버전은 그 자체로 유용합니다. 여기에는 MCP 코어, stdio 및 HTTP 전송(transport), 범용 플랫폼 어댑터, 그리고 이 저장소의 모든 공급자 어댑터가 MIT 라이선스로 포함되어 있습니다. 상용 제품의 방향은 추가적인 것이며, 관리형 운영, 개인화, 워크플로, 협업, 기록 보존, 지원에 중점을 둡니다. Product tiers를 참고하세요.

CiteWire의 용도

• 뉴스 플랫폼 운영자는 news.list, news.get, news.topics, news.about을 통해 호환 가능한 읽기 API를 노출할 수 있습니다.

• 연구자와 에이전트 빌더는 쿼리하려는 공개 뉴스 및 리서치 제공자만 활성화할 수 있습니다.

• 셀프호스팅 사용자는 동일한 서버를 stdio, 무상태(stateless) HTTP 또는 Node.js 서버리스 함수 안에서 실행할 수 있습니다.

• 공급자 기여자는 런타임 의존성을 도입하지 않고도 특정 목적에 집중된 어댑터를 추가할 수 있습니다.

CiteWire는 전문(全文) 수집 서비스, 크롤러, 게시자, 편집 시스템 또는 저작권 정리 서비스가 아닙니다. 기사 본문을 저장하거나 재게시하지 않습니다. 공급자 접근 가능성은 해당 사용 사례에 대한 공급자의 최신 이용 약관을 검토하는 것을 대체하지 않습니다.

Related MCP server: agentpulse-mcp

빠른 시작

요구 사항: Node.js 18 이상. Community는 ESM 전용 Node 패키지이며 CommonJS 진입점을 제공하지 않습니다.

공급자 하나를 활성화한 citewire.config.json을 만듭니다.

{
  "providers": {
    "openalex": { "enabled": true }
  }
}

stdio로 서버를 실행합니다.

npx -y citewire --config citewire.config.json

stdio는 기본 전송이며, MCP 클라이언트가 citewire를 로컬 프로세스로 실행할 때 일반적으로 선택됩니다.

MCP 클라이언트 구성

클라이언트가 항상 프로젝트 디렉터리에서 실행되지 않으므로 절대 경로를 사용하세요.

{
  "mcpServers": {
    "citewire": {
      "command": "npx",
      "args": [
        "-y",
        "citewire",
        "--config",
        "/absolute/path/to/citewire.config.json"
      ]
    }
  }
}

HTTP 전송

포트 8722에서 무상태(stateless) HTTP 전송을 실행합니다.

npx -y citewire --config citewire.config.json --http 8722

로컬 엔드포인트는 POST /를 통한 JSON-RPC를 허용합니다. 세션이나 이벤트 스트림을 제공하지 않습니다.

두 가지 사용 방법

1. 호환 뉴스 플랫폼 래핑

표시 이름, 사이트 URL, 읽기 API base를 갖는 플랫폼을 선언합니다.

{
  "platform": {
    "name": "Example Industry News",
    "siteUrl": "https://news.example",
    "apiBase": "https://news.example/api/v1/news"
  }
}

이 구성은 네 가지 도구를 노출합니다.

필요한 HTTP 인터페이스는 platform read-API contract에 문서화되어 있습니다.

2. 공개 공급자 도구 활성화

공급자 어댑터는 Community에 포함되며 기본적으로 비활성화되어 있습니다. 공급자는 해당 구성 항목에서 enabled를 true로 설정해야만 활성화됩니다.

{
  "providers": {
    "gdelt-doc": { "enabled": true },
    "arxiv": { "enabled": true },
    "crossref": {
      "enabled": true,
      "mailto": "operator@example.com"
    }
  }
}

Crossref는 배포자 본인의 연락 이메일을 요구하며, 이는 요청이 polite pool 안에서 운영자를 식별할 수 있도록 하기 위한 것입니다. citewire는 해당 주소를 Crossref로 보내는 요청의 mailto 매개변수와 User-Agent에만 사용하며, 그 외에는 사용하지 않습니다. 예제 주소를 복사하지 마세요.

현재의 어댑터는 다음과 같습니다.

활성화하기 전에 Providers를 읽으세요. 해당 문서는 각 어댑터의 엔드포인트, 문서, 무료 접근 기준, 알려진 관례상 한도(courtesy limits)를 기록합니다. 공급자 자체 문서가 여전히 source of truth입니다.

구성 동작

• platform은 선택 항목입니다.

• providers는 선택 항목입니다.

• 구성에서 생략된 공급자는 비활성화 상태를 유지합니다.

• 빈 구성도 유효하며 노출되는 도구가 없습니다.

• 잘못된 구성은 시작 시 실패하며, 오류 메시지에는 해당 필드 이름이 명시됩니다.

• tools/list는 실행 중인 배포의 권위 있는 도구 목록입니다. 활성화된 도구는 해당 배포의 구성에 의존하기 때문입니다.

배포에서 플랫폼과 공급자를 함께 결합할 수 있습니다.

{
  "platform": {
    "name": "Example Industry News",
    "siteUrl": "https://news.example",
    "apiBase": "https://news.example/api/v1/news"
  },
  "providers": {
    "openalex": { "enabled": true }
  }
}

선택 사항: Community 정책 기반

CiteWire는 소스 정책, 권리 평가, 셰도우 포함 평가를 위한 로컬 읽기 전용 기반을 노출할 수 있습니다.

{
  "community": {
    "enabled": true,
    "classifierMode": "shadow",
    "thresholds": {
      "adjacent_min": 0.5,
      "standard_min": 0.6
    }
  }
}

번들에 포함된 모든 소스는 기본적으로 비활성화되어 있습니다. 이 설정은 네트워크 호출을 수행하지 않고, 어떤 인증 정보도 로드하지 않으며, 게시할 수 없습니다. 인증 정보 기반 권리 확인(credentials)은 불투명한 비밀 관리자(secret-manager) 참조를 메모리에서 받아들이지만 해당 참조를 절대 반환하지 않습니다. 분류기는 반드시 셰도우 모드로 실행되며, 별도로 검토된 편집 시스템과 평가 코퍼스가 생기기 전까지 항상 publishable: false를 보고합니다.

런타임 검증, 장애 시 폐쇄(fail-closed) 정책, 표준 MCP 도구 및 리소스, 현재 제한 사항에 대해서는 Source registry and rights를 읽어보세요.

설계 경계

• MIT 및 zero dependency(무의존성) — 이 패키지는 Node 내장 기능만 사용하며 런타임 의존성이나 개발 의존성이 없습니다.

• Node ESM — Community는 ESM을 통해 Node.js 18 이상을 지원합니다. CommonJS 호환성이나 CommonJS 빌드를 제공하지 않습니다.

• 읽기 전용 — 포함된 도구는 플랫폼 및 공급자의 읽기 인터페이스만 쿼리합니다.

• 무상태(stateless) — Community 서버에는 계정, 세션, 저장된 검색 또는 보존된 이력이 없습니다.

• 출처 우선 — 결과에는 상위 플랫폼이나 공급자가 제공한 출처 메타데이터와 링크가 유지됩니다.

• 구성 기반 — 배포자가 어떤 도구가 존재하는지 결정합니다. 어떤 것도 스스로 활성화되지 않습니다.

• 저장 안 함 — 코어는 공급자 응답이나 소스 콘텐츠를 보존하지 않습니다.

이러한 경계는 project governance policy를 통해 유지됩니다.

생태계 및 제품 문서

• Product tiers — 언제나 유지되는 Community의 가치와 추가적인 상용 경계를 정의합니다.

• Distribution — 정확한 레지스트리 및 카탈로그 체크리스트를 포함하며, 수행되지 않은 항목은 PENDING으로 표시됩니다.

• Governance — 의사 결정, 공급자 관리, 호환성, 라이선싱에 대해 설명합니다.

• Providers — 각 업스트림 공급자를 문서화합니다.

• Platform contract — 호환 가능한 뉴스 읽기 API를 정의합니다.

• Contributing — 설정, 테스트, 공급자 추가, pull request 기준을 다룹니다.

• Releasing — 패키지 및 레지스트리 릴리스 통제를 정의합니다.

• Support, Security, Code of Behavioral Conduct — 커뮤니티 운영 채널을 정의합니다.

프로젝트 기원

citewire는 Karaya Group Industry News의 첫 배포를 통해 그 형태가 갖춰졌습니다. 공개 플랫폼 계약은 일반적이며 호환되는 어떤 읽기 API든 래핑할 수 있습니다.

기여하기

npm test로 테스트 스위트를 실행하세요. 설치 단계는 필요하지 않습니다. 공급자를 제안하거나 공개 계약을 변경하기 전에 CONTRIBUTING.md를 참조하세요.

라이선스

Community는 MIT 라이선스입니다. LICENSE를 참고하세요.