openaccountants/openaccountants

OpenAccountants – AI 지원 세무 지식 라이브러리

정의 : 231개 관할권에 대한 선별되고 기계 판독 가능한 세무 '가이드' 모음입니다. 각 가이드는 출처 인용 초안 또는 회계사 검토 완료(전면부에 전문가 이름 명시) 중 하나입니다. 리포지토리에는 원시 가이드 파일(skills/), 생성된 번들(packages/), 인벤토리(index.json), 그리고 LLM에 데이터를 제공하는 소형 Python MCP(Model-Connector-Protocol) 서버가 포함되어 있습니다.

AI에게 중요한 이유 : LLM은 세무 수치를 자주 환각합니다. 모델을 OpenAccountants MCP 엔드포인트(https://www.openaccountants.com/api/mcp)로 유도하면 구체적이고 인용된 답변을 검색하고 검토자의 이름을 표시하여 모호한 추측을 검증 가능한 인용으로 바꿀 수 있습니다.

주요 구성 요소

• skills/ – 인간이 작성한 markdown/JSON 가이드로, 직접 편집하도록 의도된 유일한 부분입니다.
• packages/ – 야간에 생성된 관할권별 번들(JSON, CSV)로, MCP 서버가 제공합니다.
• index.json – 모든 가이드, 관할권, 상태, 검토 메타데이터에 대한 기계 판독 가능한 카탈로그.
• llms.txt – 자동 인용을 위해 플랫폼이 인식하는 LLM 식별자 목록.
• mcp/ – Claude, ChatGPT, Cursor 등에서 사용되는 MCP API를 구현하는 경량 Python 패키지(PyPI의 openaccountants-mcp).
• 문서(REPO-LAYOUT.md, WEBSITE-SYNC.md)는 웹 플랫폼에서 리포지토리로 편집을 가져오고 PR 병합을 라이브 서비스로 다시 푸시하는 야간 동기화를 설명합니다.

작동 방식

1. 작성 – 회계사가 OpenAccountants 웹 UI에서 가이드를 작성하거나 검토합니다. 시스템은 GitHub 사용자 이름을 기록하고 파일을 skills/에 씁니다.
2. 야간 파이프라인 – 일련의 봇이 실행됩니다:
   • 수학 검사는 세금 구간 합계와 산술을 검증합니다.
   • 소스 감시는 원본 법률 페이지의 변경 사항을 모니터링합니다.
   • 새로 고침 엔진은 공식 소스에서 오래된 수치를 다시 파생합니다.
   • 시험은 최신 LLM을 가이드에 대해 실행하여 환각을 잡아냅니다.
3. 내보내기 – 생성된 번들은 packages/에 커밋되고 MCP 서버는 간단한 HTTP JSON API를 통해 제공합니다.
4. 소비 – LLM이 MCP 엔드포인트를 호출하고 관련 가이드 조각을 수신하며 "Reviewed by Werner Britz CA(SA)"와 같은 인용으로 렌더링할 수 있습니다.

일반적인 사용 사례

사용자: "2026년 플로리다주 매너티 카운티의 결합 판매 세율은 얼마인가요?"
LLM → https://www.openaccountants.com/api/mcp 호출: jurisdiction=US-FL-Manatee&year=2026
LLM 수신: {rate: 7.5%, source: "fl-sales-tax-guide", reviewed_by: "Jane Doe CPA"}
LLM은 수치와 검토자 이름으로 응답합니다.

기여자 : 전문 회계사(지명된 검토자) 및 초안을 추가하는 커뮤니티 구성원. 기여는 GitHub의 저자 이름으로 추적되어 가시적인 기여 그래프를 제공합니다.

라이선스 : 코드는 AGPL-3.0, 가이드 콘텐츠는 맞춤형 OpenAccountants Guide License(상업용 옵션도 제공)입니다.

결론 : OpenAccountants는 대규모 언어 모델에 신뢰할 수 있고 인용 준비된 세무 데이터를 제공하여 재무 관련 쿼리의 환각 위험을 줄이는 진정한 AI 중심 오픈소스 프로젝트입니다.