> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Olostep + CowAgent

> Use Olostep as CowAgent's web search provider and web fetch backend to give your agent live search and JavaScript-rendered pages as markdown.

Olostep is a built-in web search provider and web fetch backend in [CowAgent](https://cowagent.ai), the open-source AI agent and assistant framework. [Olostep](https://www.olostep.com) is web data infrastructure for AI agents and enterprise AI workflows. Its APIs provide live web search, scraping and crawling to extract, clean and structure data from the web.

* **Web search:** the agent's `web_search` tool returns each result's title, URL and description from Olostep.
* **Web fetch:** the agent's `web_fetch` tool reads pages through Olostep, which renders JavaScript and returns the page as markdown.

[View CowAgent's web search docs →](https://docs.cowagent.ai/tools/web-search)

## Why Olostep

* Web data infrastructure for developers and enterprises
* Scales to hundreds of millions to billions of requests per customer per month
* The most performant, reliable and cost-effective API on the market
* Used by the fastest-growing AI companies

From extracting data from a handful of URLs to crawling hundreds of millions of pages, Olostep gives developers, AI companies and enterprises reliable and highly cost-effective access to clean, structured web data at scale.

## Setup

**1. Get an API key**

Create a key in the [Olostep dashboard](https://www.olostep.com/dashboard/api-keys). Your first 500 credits are included.

**2. Add the key to CowAgent**

The easiest way is the CowAgent web console: open **Model Management → Search**, choose **Olostep** and save your key.

Or set it in your configuration file:

```json theme={null}
{
  "tools": {
    "web_search": {
      "olostep_api_key": "YOUR_OLOSTEP_API_KEY"
    }
  }
}
```

You can also set the `OLOSTEP_API_KEY` environment variable instead.

**3. Choose how CowAgent uses it**

With the default `auto` strategy, CowAgent can use Olostep alongside any other search providers you configured. To always search with Olostep, use the `fixed` strategy:

```json theme={null}
{
  "tools": {
    "web_search": {
      "strategy": "fixed",
      "provider": "olostep"
    }
  }
}
```

## Web fetch backend (opt-in)

CowAgent's default fetch backend only reads static HTML. To read pages through Olostep instead, including JavaScript-heavy sites, set the fetch provider to `olostep`:

```json theme={null}
{
  "tools": {
    "web_fetch": {
      "provider": "olostep"
    }
  }
}
```

It uses the same key as the search provider. Each fetch uses Olostep credits, so it stays off until you turn it on. CowAgent still downloads and parses documents such as PDF and Word files locally.

## Credits

Each search uses 5 credits, and each fetched page usually uses 1 credit. See [pricing](https://www.olostep.com/pricing) for plans.

## Resources

> [card] [CowAgent: web search](https://docs.cowagent.ai/tools/web-search)
>
> Providers, routing strategy and tool parameters

> [card] [CowAgent: web fetch](https://docs.cowagent.ai/tools/web-fetch)
>
> Fetch backends, including Olostep

> [card] [Olostep Search API](https://docs.olostep.com/features/search.md)
>
> How Olostep search works

> [card] [Support](mailto:info@olostep.com)
>
> [info@olostep.com](mailto:info@olostep.com)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.