확장 프로그램이나 스킬 없이 Pi에서 웹 검색하기: 복사, 붙여넣기, 그리고 잊어버리기

Pi가 웹 검색을 하게 만들고 싶으면 brew install ketch로 Ketch를 설치하고 아래 지침을 붙여넣어 봐. 그럼 Pi가 최신 정보가 필요할 때마다 알아서 써먹을 거야. 확장 프로그램도, 스킬도, MCP도 필요 없어.

그 파일은 ~/.pi/agent/APPEND_SYSTEM.md야. Pi가 세션 전체에 걸쳐 기본 지침으로 추가하는 일반 마크다운 파일이니까, 없으면 새로 만들면 돼. 난 Ketch README에 있는 에이전트 프롬프트 예시로 시작해서 내 입맛대로 좀 수정했어. 이걸 파일에 그대로 복사해 넣어:

Use `ketch` for external research — web pages, OSS code, library docs. Add `--json` to every call.

• Instead of web_search, run `ketch search "query"` (add `--multi` to federate backends).
• Instead of web_fetch, curl or wget, run `ketch scrape <url> [url...] --max-chars 6000 --trim`;
  it returns clean markdown, not raw HTML. Found a URL? Read it; don't search for it again. Keep
  the cap: an unbounded page can cost ~25k tokens (same flags on `search --scrape`).
• Public source code: `ketch code "<exact text>"` searches public GitHub repos for that literal text.
  Use `--lang <language>` to filter by language or `--repo owner/name` (also accepts a GitHub URL)
  to search one exact repository.
• Library docs, two steps: `ketch docs --resolve "library name"` → check that the match names the
  library you meant → `ketch docs "question" --library <id-from-resolve>`.
• Exit codes are control flow: 2 fix your input · 3 nothing matched, change the query ·
  4 backend/network, retry once or pick another backend (`-b`, see `ketch config`) ·
  5 missing config, stop and tell the user · 6 cancelled.
• Multi-session work: add `--tag <project>` to calls worth keeping and check `ketch tag show <project>`
  before searching again.
• `ketch <cmd> --help` is authoritative for flags.

저장하고 Pi에서 /reload를 입력해. Ketch 기본 웹 검색은 API 키가 필요 없고, 이 설정 하나면 Pi가 페이지 스크래핑, 공개 코드 검색, 라이브러리 문서 조회, 나중에 다시 볼 소스 태깅까지 다 할 수 있어(즉, 여러 제공업체에서 무료 API 키를 한 번만 받아두면 된다는 소리).

선택 사항으로 괜찮은 무료 업그레이드 방법이 하나 있는데, Brave Search API는 현재 매달 5달러 크레딧을 줘. 정해진 검색 요금 기준으로 약 1,000번 정도 검색할 수 있는 양이야. Brave는 계정이랑 결제 카드를 등록해야 하는데, 크레딧만 써도 돈 나갈 일은 없으니까 걱정 마. 키를 받았으면 를 실행해. 그럼 Ketch의 기본 백엔드가 Brave를 우선적으로 쓰게 될 거야.