v1.5.0

What's New

• Content completeness assessment — detects truncated articles with 5 signals
• Retrieval workflows — recover-article, capture-site, build-research-pack
• Corpus storage — runtime data in writable user data directory via platformdirs
• 12-step extraction chain — auth + residential IP steps added
• Completeness-aware extraction — free extractors auto-fallthrough on truncated content
• Streamable HTTP MCP transport — for Antigravity clients
• Obscura stealth browser — CLI step + CDP backend for Playwright
• Python badge fix — cleaner shields.io format

Upgrade

pip install --upgrade argus-search

v1.4.0

What's new

• WolframAlpha LLM API (Tier 0, 2,000 free calls/month): computed answers for math, unit conversions, and factual queries. Appears in grounding and research modes alongside web results. Free API key at developer.wolframalpha.com.
• Yahoo Search (Tier 0, no API key): second no-key scraped provider for pip-only installs. Auto-disabled by health tracker if Yahoo HTML changes.
• 14 providers total (up from 11)
• 7,000+ free queries/month from recurring free-tier providers (up from 5,000+)
• SearXNG story: now clearly documented as aggregating 70+ engines (Google, Bing, Yahoo, Startpage, Ecosia, Qwant, and more)
• Updated routing policies: Yahoo in all modes, Wolfram in grounding and research
• Updated README, CLAUDE.md, llms.txt, llms-full.txt, server.json to reflect new providers

Upgrade

pip install --upgrade argus-search

v1.3.3

What's Changed

Features

• MCP Registry — published to modelcontextprotocol.io as io.github.Khamel83/argus
• GitHub search provider (free, tier 0) — 10 req/min unauthenticated, 30/min with token
• Valyu — search, contents extraction, and AI-synthesized answers with citations
• Firecrawl — content extraction (1 credit/page)
• Pace-aware routing — always queries free providers, paces paid ones
• Proactive balance checking — header parsing + Tavily usage API for live balance tracking

Docs

• Product page quality pass — features, JSON examples, modes, FAQ
• README/CLAUDE.md updated for new providers and MCP Registry listing
• Registry-based install option added to MCP quickstart

Full Changelog: v1.3.1...v1.3.3

v1.3.2

What's Changed

New Providers

• GitHub search (free, tier 0) — code search with rate limiting
• Valyu — search, contents extraction, and AI-synthesized answers with citations
• Firecrawl — content extraction (1 credit/page)

Improvements

• Pace-aware routing — always queries free providers, paces paid ones based on remaining budget
• Proactive balance checking — live balance tracking via API headers
• Documentation pass — features, JSON examples, modes, FAQ

Full Changelog: v1.3.1...v1.3.2

v1.3.1

What's New

DuckDuckGo provider — Zero-config free search. No API key, no Docker, no setup. pip install argus-search && argus search -q "anything" works immediately.

Two deployment tiers:

• No server: DuckDuckGo + API keys (5,000 free monthly queries). Runs on any machine with Python 3.11+.
• Full install: Add SearXNG on a Raspberry Pi alongside Pi-hole (512MB RAM). Your Pi-hole Pi is now also your private search engine.

Fixed credit claims — All provider numbers now reflect standard signup amounts, not promotional deals. See CHANGELOG.md for full history.

Installation

pip install argus-search

Full list of changes: CHANGELOG.md

v1.3.0

New search providers (3)

• Linkup — monthly recurring (1,000 queries/mo), tier 1
• Parallel AI — one-time credits (16,000 queries), tier 3
• You.com — $100 credit, tier 3, also available as content extractor ($1/1k pages)

New extractors (2)

• Crawl4AI — self-hosted JS rendering, no API cost. Install with pip install "argus-search[crawl4ai]"
• You.com Contents API — $1/1k pages, gated by ARGUS_YOU_CONTENTS_ENABLED

Tier-based credit-aware routing

Providers sorted by credit type before dispatch:

• Tier 0: SearXNG (free, unlimited) — always first
• Tier 1: Brave, Tavily, Exa, Linkup (monthly recurring)
• Tier 3: Serper, Parallel, You.com (one-time credits) — last resort

Mode-specific ordering preserved within each tier. Budget enforcement skips exhausted providers automatically.

Budget enforcement

All providers now have query-count budgets set in .env. When a provider's 30-day rolling usage hits its budget, it's skipped until the window resets.

Full changelog: 18 files changed, 758 insertions, 185 deletions. 173 tests passing.

v1.2.1

• Fix MCP server: sync with mcp 1.26+ API (sync entry point, remove invalid version kwarg, fix run() args)
• Rename PyPI package to argus-search (name conflict with unrelated project)