@datasee/forager

forager — 캐시바이 서치 콘솔 — 을 터미널에서 다루는 CLI. forager mcp 로 MCP 서버가 되어 Claude 같은 AI 도구가 속성을 등록하고, 크롤을 요청하고, 색인 상태를 읽고, 수집된 상품을 검색할 수 있다.

npm i -g @datasee/forager
forager login --url https://search.datasee.co.kr
forager properties list

login 은 사내 SSO 로 붙는다. 브라우저가 열리고 승인하면 끝이다 — 키를 복사해 붙일 일이 없다. 무인 실행(CI, 서버 연동)처럼 브라우저를 띄울 수 없는 곳에서는 콘솔 설정 › API 키에서 발급한 키를 쓴다:

forager login --url https://search.datasee.co.kr --key fgr_...

자주 쓰는 것

forager properties list                                   # 속성(도메인)과 크롤·차단 상태
forager properties add domain bio-rad.com --brand Bio-Rad # 도메인 추가 → 즉시 크롤 (편집자 이상)
forager properties status <id>                            # 색인·제외 사유·상품 수 요약
forager properties request <id> url https://…/sku/123     # 특정 URL 을 큐 맨 앞으로
forager properties request <id> site                      # 전체 재크롤
forager inspect https://…/sku/123 --property <id>         # 실시간 fetch + 추출 결과 (--render 로 헤드리스 Chrome)
forager products "hitrap sp" --brand Cytiva               # 수집 상품 검색 (파트넘버·이름)

MCP

Claude Code / Claude Desktop 에 붙이기 (~/.mcp.json 또는 claude mcp add):

{
  "mcpServers": {
    "forager": {
      "command": "forager",
      "args": ["mcp"],
      "env": { "FORAGER_URL": "https://search.datasee.co.kr", "FORAGER_API_KEY": "fgr_..." }
    }
  }
}

forager login 을 먼저 했다면 env 없이도 ~/.config/forager/config.json 의 세션을 쓴다.

도구: forager_properties · forager_property_add · forager_property_update · forager_inspect_url · forager_request_crawl · forager_index_status · forager_index_urls · forager_crawl_stats · forager_sitemaps · forager_snippets · forager_products_search · forager_product_get · forager_users · forager_user_update · forager_admin_status · forager_property_remove(confirm 필수)

설정

~/.config/forager/config.json (FORAGER_CONFIG 로 위치 변경). 환경변수 FORAGER_URL · FORAGER_API_KEY · FORAGER_TOKEN 이 파일보다 우선한다.

라이선스

MIT