WYRD/TOOLS

Tools / seek / Providers

Providers

seek is a thin, uniform layer over several provider APIs. Commands are grouped by intent (search, research, scrape); within a command you pick the provider whose trade-offs fit your query. Every provider requires its own API key — see Configuration.

ProviderCommandsBest for
Parallelweb, research, scrapeDense, LLM-ready context; strict-JSON deep research; extraction
Exaweb, scrapeNeural semantic search; bulk clean page text
Brave Searchweb brave searchReal-time facts from an independent global index
Brave Answersweb brave answers, research braveAI answers with verifiable sources; deep research
Perplexityweb, researchShort cited answers; polished long-form briefings
Google/Geminiresearch googleLong-horizon, Google-grounded reports
Firecrawlscrape firecrawlClean Markdown/HTML/JSON/screenshots from any live URL

Parallel

The most versatile provider — used by all three commands.

  • web — returns relevant excerpts optimized for LLMs, replacing multiple keyword searches with a single call for broad or complex queries.
  • research — Parallel Deep Research with tunable processor depth (core-fastultra) and optional strict JSON output via a schema file. Best for B2B and data-ops work where output must be auditable. Supports resumable --async submission plus later research status and research get calls.
  • scrape — the /v1/extract endpoint returns clean markdown excerpts (and optional full content) plus publish dates, and can authenticate through logins and paywalls.

Exa

Neural semantic search that finds pages by meaning rather than keywords.

  • web — best for conceptual queries; supports search types (autodeep-reasoning), category filters, and date windows.
  • scrape — bulk page parsing that returns stripped text optimized for LLM token windows.

Brave

Brave exposes two separate APIs, provisioned and keyed independently.

  • Brave Search (web brave search) — clean, structured snippets from an independent global web index; best for real-time consumer facts, with optional freshness and country filters.
  • Brave Answers (web brave answers, research brave) — AI-generated answers backed by verifiable sources. The same endpoint powers deep research when the research flag is enabled. Research remains synchronous because the streaming endpoint does not expose a resumable job id.

Perplexity

Synthesizes the web into cited answers.

  • web — short, conversational answers with citations; model, recency, search mode (web/academic), and domain filters are configurable.
  • research — Sonar Deep Research (async job) for polished long-form briefings with inline citations and a tunable reasoning-effort level. Supports resumable submission and later status/result retrieval.

Google (Gemini)

  • research google — the Gemini Deep Research Agent autonomously plans, executes, and synthesizes multi-step research into a detailed, cited report. Runs can take several minutes; resumable submission and an interactive plan-approval mode are available. With --interactive --async, the plan is approved before the provider job is submitted.

Resumable provider jobs

Google, Parallel, and Perplexity expose durable provider jobs. seek research <provider> <query> --async returns a provider-qualified locator without polling. seek research status <provider> <job-id> and seek research get <provider> <job-id> reconnect directly to that remote job; no local daemon or job-history database is involved. See Research for command examples and the JSON lifecycle contract.

Firecrawl

  • scrape firecrawl — turns any live URL into clean Markdown, HTML, raw HTML, links, a summary, a screenshot, or LLM-extracted JSON, with controls for JS rendering, mobile viewport, ad blocking, proxy modes, and caching.

Choosing a provider

  • Not sure which to use? Start with Parallel for web and research, and Firecrawl for scrape.
  • Running a command without the matching key prints the missing-key error plus a ranked list of sibling providers, marking which ones you already have keys for.