<p align="center">
<img src="https://raw.githubusercontent.com/taxueseek/argo/HEAD/assets/readme/hero.svg" width="100%" alt="Argo: 수백 개의 소스와 18개 언어에 걸친 AI 에이전트를 위한 통합 검색 및 증거 검증 시스템">
</p>
<p align="center">
<strong>English</strong> ·
<a href="README.zh.md">中文</a> ·
<a href="README.ja.md">日本語</a> ·
<a href="README.ko.md">한국어</a> ·
<a href="README.es.md">Español</a>
</p>
<p align="center">
<a href="#quick-start">빠른 시작 (Quick Start)</a> ·
<a href="#why-argo">Argo가 필요한 이유 (Why Argo)</a> ·
<a href="#query-shaped-routing">라우팅 증명 (Routing Proof)</a> ·
<a href="#how-it-works">작동 방식 (How It Works)</a> ·
<a href="#ai-search--sub-skills">AI 검색 및 하위 기술 (AI Search & Sub-skills)</a> ·
<a href="#dsh-plugin">DSH 플러그인 (DSH Plugin)</a> ·
<a href="#docs--changelog">문서 (Docs)</a>
</p>
<p align="center">
<a href="https://github.com/taxueseek/argo/stargazers"><img alt="스타" src="https://img.shields.io/github/stars/taxueseek/argo?style=social"></a>
<a href="https://www.npmjs.com/package/argo-search"><img alt="npm 다운로드 수" src="https://img.shields.io/npm/dm/argo-search?color=cb3837&label=npm%20downloads"></a>
<a href="https://skills.sh/taxueseek/argo"><img alt="skills.sh" src="https://img.shields.io/badge/skills.sh-argo-black"></a>
<img alt="라이선스" src="https://img.shields.io/badge/license-Apache_2.0-blue">
<img alt="python" src="https://img.shields.io/badge/python-3.9+-green">
<img alt="버전" src="https://img.shields.io/badge/version-2.14.1-informational">
<img alt="엔진" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Ftaxueseek%2Fargo%2Fmain%2Fassets%2Freadme%2Fcounts.json">
<img alt="mcp" src="https://img.shields.io/badge/MCP-19%20tools-purple">
</p>
taxueseek 스킬 시리즈의 일부 (검색 및 심층 리서치): plainspoken-writing 75★ (AI 톤 제거) · session-digger 34★ (교차 환경 세션 마이닝) · taxue-invest 30★ (투자 분석) · taxueskills 25★ (의사 결정 시스템) · taxue-creative-style 19★ (창작 일러스트레이션 스타일) · ime-lexicon 15★ (IME 사전 도구 키트).
DeepSeek Harness (DSH) 플러그인 에코시스템: dsh-files 43★ (폴더 업로드 + 문서 파싱) · plugin-fast-adapt 15★ (플러그인 업그레이드 어댑터) · taxue-dsh-artisan 3★ (시각적 생성) · dsh-plugin-guard 2★ (사전 설치 감사).
Argo는 AI 에이전트 내부에 존재하는 오픈 소스 메타 검색(metasearch), 웹 가져오기(web-fetch), 증거 검증 엔진입니다. 이 엔진은 수백 개의 소스에서 18개 언어에 걸쳐 쿼리를 라우팅하며(웹, 학술, 금융, 코드, 로컬 파일, 그리고 주요 AI 검색 엔진), API 키가 없을 때는 키리스 및 로컬 엔진으로 폴백하고, 검색 스니펫을 신뢰하는 대신 전체 페이지 텍스트에서 사실을 검증합니다.
빠른 시작 (Quick Start)
설정 불필요(zero-config)로 즉시 작동합니다 (API 키는 선택 사항입니다). 사용할 클라이언트를 선택하세요:
- Claude Code (MCP):
claude mcp add argo -- npx -y argo-search
- 에이전트 스킬 (
skills.sh — Claude Code, Cursor, Codex, Antigravity):
npx skills add taxueseek/argo
npx skills add taxueseek/argo --full-depth --all
- Cursor / Windsurf / LibreChat (
mcpServers JSON):
{
"mcpServers": {
"argo": { "command": "npx", "args": ["-y", "argo-search"] }
...
- **로컬 CLI (장기적인 로컬 사용에 권장)**:
```bash
curl -fsSL https://raw.githubusercontent.com/taxueseek/argo/main/scripts/install.sh | bash
# 또는 npm을 통해: npm install -g argo-search
- DeepSeek Harness (DSH) 플러그인:
dsh plugin --profile web add argo-search
<details>
<summary>설치, 요구 사항 및 선택적 API 키 확인</summary>
argo search "python asyncio error handling" --verify 2 --json --fields agent
argo search --list-engines
- 요구 사항: Python 3.9+ (
pip install pyyaml) 및 Node.js 18+ (npx용).
- 선택적 키 (
DEEPSEEK_API_KEY, ARGO_YUANBAO_API_KEY, ARGO_TAVILY_API_KEY, EXA_API_KEY, ARGO_METASO_API_KEY, ARGO_BOCHA_API_KEY)는 존재할 경우 품질을 향상시키며, 누락된 경우 자동으로 건너뜁니다. docs/MCP_SETUP.md 및 docs/ENGINE_CATALOG.md를 참조하십시오.
</details>
Argo가 필요한 이유 (Why Argo)
<p align="center">
<img src="https://raw.githubusercontent.com/taxueseek/argo/HEAD/assets/readme/why-better.svg" width="100%" alt="Argo가 내장 검색, 단일 AI 검색 API 및 일반 메타 검색보다 우수한 이유">
</p>
| 기능 (Capability) | 내장 웹 검색 (Built-in Web Search) | 상업용 검색 API (Tavily / Exa / Serper) | Argo |
| :--- | :--- | :--- |
| 가격 및 키 | 호스트 할당량에 종속됨 | 호출당 유료; API 키 필요 | 무료 및 키 없는 폴백 (선택적 키가 품질 향상)
| ... |
쿼리 기반 라우팅 (Query-Shaped Routing)
<p align="center">
<img src="https://raw.githubusercontent.com/taxueseek/argo/HEAD/assets/readme/proof-routes.svg" width="100%" alt="Argo query-shaped routing across finance, academic, code, and general domains">
</p>
Argo는 디스패치(dispatching) 전에 쿼리를 도메인 및 언어별로 분류한 후, 파티원 소스(first-party sources)에 직접 접근하고 합의(consensus)에 도달하면 **조기 중단(early-stop)**을 트리거합니다:
- 학술 (Academic) →
arxiv, semantic_scholar, openalex, crossref, pubmed (--academic-deep)
- 금융 및 거시 경제 (Finance & Macro) →
sec_edgar, yahoo_finance, sina_quote, eastmoney
- 코드 및 기술 (Code & Tech) →
stackoverflow, github, octen, context7
- AI 검색 (AI Search) →
tavily_free, felo, parallel_free, anysearch, deepseek_search, yuanbao, metaso, bocha, exa, tavily, you
- 심층 연구 (Deep Research) →
python3 scripts/research.py "topic" --depth deep --json은 구조화된 보고서(dossier) (소스, 커버리지 격차, 품질 게이트)를 출력합니다.
작동 방식 (How It Works)
<p align="center">
<img src="https://raw.githubusercontent.com/taxueseek/argo/HEAD/assets/readme/workflow.svg" width="100%" alt="Argo retrieval, RRF fusion, fetch degradation chain, and evidence scoring pipeline">
</p>
증거 점수화 (Evidence Scoring) (선택 × 흡수)
검색 엔진은 클릭을 최적화하지만, 에이전트는 **검증 가능한 사실(verifiable facts)**이 필요합니다. Argo는 모든 후보를 두 개의 직교 축(orthogonal axes)을 따라 점수화합니다:
- 선택 (Selection): 도메인 권위성, 엔진 간 합의(consensus) (
RRF), 최신성, 그리고 SERP-shell 거부(baidu/s 및 sogou/link에서 기본 소스로 위장하는 리다이렉트 스텁 차단).
- 흡수 (Absorption): 전체 페이지를 가져온 후 실제 읽을 수 있는 밀도(
--verify N)와 수치적 교차 확인 (--numverify N - 가격, 재무 정보 및 날짜용).
예산 모드 (Budget Modes) (--mode)
| Mode | 동작 방식 (Behavior) | 최적의 용도 (Best for) |
|---|
fast | 무료 + 로컬 local_* 엔진만 사용, API 지출 제로 | 고빈도 에이전트 조회 |
| ... | | |
AI 검색 및 하위 기술 (AI Search & Sub-skills)
하위 기술 (Sub-skills) (4가지 내장 파이프라인)
기능 및 도구 세부 사항
| 하위 기술 | 기능 |
|---|
| local-search | 로컬 파일 검색 및 32개의 제로 비용(zero-cost) 로컬 집계 엔진(--local-first) 지원 |
| ... | |
19 MCP 도구
argo_search, argo_local_search, argo_local_read, argo_recompute, argo_research, argo_evidence, argo_clarify, argo_fetch, argo_crawl, argo_screenshot, argo_pdf, argo_social_search, argo_article, argo_job, argo_extract, argo_preflight, argo_answer, argo_watch, argo_cite.
DSH 플러그인 (DSH Plugin)
Argo는 최고 수준의 DeepSeek Harness (DSH) 플러그인(@taxueseek/argo-dsh)을 제공하며, 이 플러그인은 하나의 기능 세트에서 다음 세 가지 호출 채널을 사용합니다:
- 19개의
mcp__argo__* 도구 (메인 패키지 번들로, 전체 MCP와 동일함).
- 검색(Search) +
wide_research 병렬 오케스트레이션 (하위 패키지).
- 호스트
web_search / web_fetch 시음 교체 (웹 프로필에서 명시적인 제공자 핀(provider pin)이 필요함; packages/dsh-plugin/README.md 참조).
내장 설정 UI는 18개의 네이티브 최고 수준 도구, 28개의 큐레이션된 엔진 스위치를 노출하며, 평문(plaintext) 반향 없이 DSH의 네이티브 DEEPSEEK_API_KEY 자격 증명 저장소를 공유합니다:
<p align="center">
<img src="https://raw.githubusercontent.com/taxueseek/argo/HEAD/assets/readme/settings-tools.webp" width="32%" alt="DSH 도구 설정 탭">
<img src="https://raw.githubusercontent.com/taxueseek/argo/HEAD/assets/readme/settings-engines.webp" width="32%" alt="DSH 엔진 설정 탭">
<img src="https://raw.githubusercontent.com/taxueseek/argo/HEAD/assets/readme/settings-keys.webp" width="32%" alt="DSH 키 설정 탭">
</p>
문서 및 변경 로그 (Docs & Changelog)
| Version | Highlights |
|---|
| v2.14.1 | 아키텍처 간소화(Architecture slimming), MCP 3+1 직교 도구(orthogonal tools) 및 하위 호환 별칭 추가, 304개 소스 지원, 실패 시 폐쇄형(fail-closed) secret_guard.py 마스킹 기능 |
| ... | |
<details>
<summary>v2.14.1 릴리스 요약 및 기능 스냅샷</summary>
기능 (Capabilities) (v2.14.1)
v2.14.1은 소스 아키텍처를 간소화하고, MCP 도구를 하위 호환 별칭(backward-compatible aliases)을 가진 3+1 직교 핵심 인터페이스로 통합하며, 키가 필요 없는 소스(keyless sources) (Hugging Face Datasets, Maven Central, NuGet, Open-Meteo)를 확장하고, 실패 시 폐쇄형(fail-closed) secret_guard.py 출력 마스킹 기능을 추가합니다.
v2.14.1: 아키텍처 간소화 + MCP 3+1 도구 + 보안 마스킹
docs/RELEASE_NOTES_v2.14.1.md와 docs/CHANGELOG.md를 참조하세요.
</details>
기여 및 라이선스
이슈(Issue) 및 풀 리퀘스트(PR)를 환영합니다 (소스 추가 방법은 docs/ADDING_NEW_ENGINE.md 참조). 라이선스는 Apache-2.0을 따릅니다.