# Web Search

> Skill `web-search` on Faro. 5 sub-skills.

Searches the live web and returns ranked results with titles, links, and excerpts, routing your request to the right approach. Whether you need a quick answer, news, a file, a site-scoped search, or a broad topic survey, describe what you want and the skill picks the best strategy. Results are raw hits for you to triage, not a synthesized answer -- use Research for AI-written cited summaries.

**Category:** Web & Search  
**Tags:** web-search, search-api, news, current-events, ranked-results  
**Use when:** You need fresh, external, or verifiable information from the live web rather than memory.  
**Not for:** Reading a full page's text, AI-synthesized cited answers, or image, video, or local-business search.  
**Returns:** information — Returns ranked results (title, link, and a snippet per result), not full page text and not a synthesized answer. Snippets are excerpts to triage and cite, not the source of truth; read the linked page for the full content.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/web-search/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"What's the latest stable version of Node.js?"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run web-search "What's the latest stable version of Node.js?"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- What's the latest stable version of Node.js?
- Search the React docs for useState hooks
- Get me the AWS S3 pricing guide as a PDF
- What are the latest headlines about US inflation?

## Sub-skills

### Quick lookup

Finds a single fact, document, or official site with one focused query.

**Cost:** 6.25 credits / search

**Use when:** You want a specific answer, link, or official source and one good search will do.

**Details:** https://askfaro.com/llms/skills/web-search/lookup.md

---

### Search a site

Searches within or across specific sites or domains.

**Cost:** 6.25 credits / search

**Use when:** You want results only from one site or a small set of trusted domains.

**Details:** https://askfaro.com/llms/skills/web-search/site_search.md

---

### Find a document

Finds documents such as PDFs, manuals, reports, or specifications.

**Cost:** 6.25 credits / search

**Use when:** You want a downloadable document rather than a web page.

**Details:** https://askfaro.com/llms/skills/web-search/filetype_lookup.md

---

### News and current events

Searches recent news and headlines, with optional region or language targeting.

**Cost:** 6.25 credits / search

**Use when:** You want current, time-sensitive coverage rather than evergreen reference pages.

**Details:** https://askfaro.com/llms/skills/web-search/news.md

---

### Research scan

Maps a topic with one broad search, then narrows into subtopics across several searches.

**Cost:** 6.25 credits / search — Runs one broad search to map sources, then a few targeted follow-ups, each at this price.

**Use when:** You are starting research and need to find and diversify the key sources on a topic.

**Details:** https://askfaro.com/llms/skills/web-search/research_scan.md

---

---
On the web: https://askfaro.com/search/web-search