apmantza/GreedySearch-claude

GreedySearch registers the greedy_search tool for Pi: headless-first,
no-API-key AI/web search through a dedicated Chrome profile.
What It Does
- Multi-engine search across Perplexity, Google AI, ChatGPT, and Gemini
- Source-grounded engine: "all" results with fetched source content
- Optional synthesis over engine answers and fetched sources
- Iterative depth: "research" runs with citation audit and research bundles
- Visible Chrome fallback for login/captcha/cookie setup when needed
Install
Or from git:
Quick Usage
Headless is the default. Use visible: true only when you need to establish a
session, solve a challenge, or inspect the browser:
MCP server
GreedySearch also ships a dependency-free MCP stdio server (bin/mcp.mjs)
so Claude Code — or any MCP client — can call it directly, outside of Pi.
It exposes two tools:
- greedy_search — same parameters as the Pi greedy_search tool
(query, engine, synthesize, synthesizer, depth, breadth,
iterations, maxSources, researchOutDir, writeResearchBundle,
fullAnswer, locale, visible). Spawns bin/search.mjs under the
hood; searches take roughly 1-5 minutes.
- greedy_fetch — fetch a single URL and return its extracted
title/byline/content (url, maxChars).
Register with Claude Code
This repo includes a project-scope .mcp.json at the repo root, so running
Claude Code from inside a checkout picks up the greedysearch server
automatically (you'll be prompted to approve project-scoped servers on
first use).
To register it manually (e.g. from outside the repo, or in user scope):
Or run the server directly for testing:
Sample tools/call
Documentation
- Usage guide — tool parameters, search modes, and config
- Research mode — iterative workflow and bundle layout
- Runtime and Chrome — slash commands, env vars, CDP safety
- Source fetching — supported source types and metadata
- Development — project layout, tests, and smoke checks
- Release workflow — changelog scripts and GitHub releases
Requirements
- Chrome or Chromium
- Node.js 20.11.0+
Contributing
See CONTRIBUTING.md and AGENTS.md for the
extractor, recovery, and release checklists.