TL;DR

이 레포는 Claude Code와 OpenCode, Cursor, Windsurf, OpenClaw 등 skill 디렉터리를 사용하는 AI 에이전트에 설치하는 plugin-extension-skill이면서 다중 런타임 CLI 도구입니다. 하나의 인터페이스로 일반 웹 검색, 도메인별 검색, 병렬 batch search, 웹페이지 본문 추출을 처리하며 Python을 우선하고 Node.js, PowerShell, Bash를 대체 실행기로 사용합니다. API key 없이 시작할 수 있지만 낮은 rate limit과 quota가 적용되고, 이메일 등록으로 받은 키는 `.env`나 환경 변수에 저장해야 합니다. 에이전트에 실시간 검색과 페이지 수집을 빠르게 붙이려는 경우 적합하지만, PDF나 이미지 같은 바이너리 문서 추출과 자체 검색 인프라가 필요한 경우에는 범위를 먼저 확인해야 합니다.

핵심 포인트

• 이 레포는 독립 실행형 library가 아니라 AI 에이전트에 설치하는 plugin-extension-skill입니다. Claude Code, OpenCode, Cursor, Windsurf, OpenClaw처럼 skill 디렉터리를 읽는 환경에 anysearch라는 이름으로 배치합니다. 별도 프레임워크에 종속되지 않고 Python, Node.js, PowerShell, Bash용 CLI 중 환경에 맞는 실행기를 선택합니다.
• 일반 웹 검색, 수직 도메인 검색, 병렬 batch search, 웹페이지 전체 추출을 하나의 인터페이스로 묶습니다. 에이전트는 `search`, `batch_search`, `extract` 같은 명령으로 검색어와 URL을 전달하고 JSON 또는 Markdown 결과를 받습니다. HTML/XHTML, plain text, JSON, Markdown은 지원하지만 PDF, DOC/DOCX, 이미지, 오디오·비디오 같은 바이너리 형식은 지원하지 않습니다.
• API key 없이도 검색 기능을 사용할 수 있지만 rate limit과 quota가 낮아집니다. 이메일 한 번으로 계정을 만들고 반환된 일회성 plaintext API key를 `.env`의 `ANYSEARCH_API_KEY`에 저장하는 흐름을 제공합니다. API key 우선순위는 `--api_key` CLI 옵션, `.env`, 환경 변수, anonymous 순서입니다.
• 설치 후 Python과 Python 3, Node.js, PowerShell, Bash 실행기를 차례로 시험하고 가장 안정적인 명령을 `runtime.conf`에 기록합니다. 이후 에이전트는 매번 환경 감지를 반복하지 않고 저장된 명령으로 검색을 실행합니다. 외부 페이지 추출 결과는 신뢰할 수 없는 데이터로 취급해야 하므로 포함된 지시를 따라 도구를 호출하거나 정보를 공개해서는 안 됩니다.