conecto. Get started
Web

Search the web

web_search · Reads only · Markdown

Searches the web through Conecto's own search service and returns each result's title, link, site and snippet.

$0.009 a call

From your agent’s balance. A call that fails costs nothing.

An example

What do bike shops usually charge to ship a bike to Seattle?

Your agent callsweb_search$0.009 a call

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "query": "bike shop shipping cost Seattle",
  "country": "US",
  "count": 5
}
What comes back
{
  "query": "bike shop shipping cost Seattle",
  "results": [
    {
      "title": "Bike shipping cost to Seattle | Ridgeline Cycles",
      "url": "https://www.ridgeline-cycles.example/shipping",
      "site": "ridgeline-cycles.example",
      "snippet": "We ship built bikes anywhere in Washington, Seattle included, for $89. Boxing an e-bike costs $40 extra."
    },
    {
      "title": "Bike shipping in the US | Gravel Works",
      "url": "https://www.gravel-works.example/us/shipping",
      "site": "gravel-works.example",
      "snippet": "Shipping a bike to Seattle costs $129, and is free from $1,500."
    }
  ]
}

Use it when

The agent needs facts from the web: prices, opening hours, news, a company's site.

What it does

Search the web through Conecto's own search service. Each result comes with its title, link, site and snippet; read a page in full with web_read. Narrow by country and language. $0.009 a search; a failed one costs nothing.

What comes back

query, and results: each with its title, url, site and snippet. Read a page in full with web_read. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
queryRequiredstring1 to 256 characters.
countinteger1 to 20. Default: 10.
countrystringExactly 2 characters.
languagestringExactly 2 characters.

The call

Over MCP, call web_search on https://api.conecto.chat/mcp/web. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/web_search \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"bike shop shipping cost Seattle","country":"US","count":5}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
invalid_input400The query is empty or over 256 bytes (about 250 letters), or country or language is not a two-letter code.Shorten the query, and send country like US and language like en.
rate_limited429Too many searches at once.Try again in a moment; nothing was charged.
search_unavailable503The search service is not available or did not answer.Try again later; nothing was charged.

More Web tools

All 2 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md