Skills/Web Search/Search a site

Search a site

6.25 credits / search

Searches within one or more specific websites or domains rather than the whole web. Provide the site you want to search and describe what you are looking for. Useful when you want results only from a particular publisher, documentation site, or a set of trusted sources.

Use when

You want results only from one site or a small set of trusted domains.

Not for

An open web search across all sources.

Cost

6.25 credits / search

What it accepts

Set these inside the intent when you run it.

queryrequired

What you want to find within the site, in plain words.

siterequired

The site or domain to scope the search to.

recencyoptional

How recent results must be, e.g. today, this week, this month, this year.

What you get back

Ranked results from within the specified site or domain, with title, link, and excerpt.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Web Search skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/web-search/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"site_search","query":"useState hooks tutorial","site":"react.dev","recency":"this month"}}'

Example requests

  • Search the React docs for useState hooks
  • Find climate change articles on The Guardian
  • Look for earnings reports on wsj.com