Tools/web-search
Web Search

Web Search

Active

Your agent answers from stale training data; this searches the live web and returns ranked, linkable results.

1 tool

Search the live web with Brave's independent index of 30B+ pages and get back ranked results with titles, links, and snippets. Controls for recency, region, language, and safe search. For AI-synthesized, cited answers, use the Research tools.

Web & Searchweb-searchsearch-apinewscurrent-eventsranked-results

Tools (1)

Search the live web and return ranked results with titles, links, and snippets, for general lookups, research, fact-checks, or the latest news and current events. Powered by Brave's independent index of 30B+ pages with ~100M updates/day. Tune queries with recency filters (last day/week/month/year), country and language targeting, safe search level, pagination, and extra snippets per result.

6.25 credits/call ($0.00625) · 6.25 credits per call

Example prompts

  • Search for documentation on Python asyncio
  • Find the official site for OpenTelemetry
  • Get the latest news on the US elections
  • Pull recent headlines about the Fed rate decision
  • Look up reviews of the Sony WH-1000XM5
  • Search for news about the SpaceX launch this week
  • What's the current population of Tokyo?
  • Find news articles about OpenAI from the last 7 days

Parameters

qstringrequired

Search query. Supports site:, -exclude, "exact phrase", filetype:pdf.

countintegeroptionaldefault: 10

Results to return (1–20).

countrystringoptional

ISO 3166-1 alpha-2 country code, e.g. "US".

freshnessstringoptional

Time filter: pd=24h, pw=7d, pm=31d, py=year.

safesearchstringoptionaldefault: "moderate"
search_langstringoptional

Content language (ISO 639-1), e.g. "en".

extra_snippetsbooleanoptionaldefault: false

Include up to 5 extra excerpts per result.

API Usage

curl -X POST "https://skill.askfaro.com/skills/web-search/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Search for documentation on Python asyncio"
  }
}'

CLI Usage

askfaro describe web-search/web_search

Install pip install askfaro-cli, then askfaro auth login.