strands-olostep

Olostep tools for Strands Agents — give your agents live web search, scraping, crawling, and cited AI answers.

Installation

pip install strands-olostep

Configuration

Set your Olostep API key as an environment variable. Get one from the Olostep dashboard — the free tier includes 500 credits.

export OLOSTEP_API_KEY="your-api-key"

Usage

from strands import Agent
from strands_olostep import (
    olostep_answers,
    olostep_crawl,
    olostep_get_crawl_results,
    olostep_map,
    olostep_scrape,
    olostep_search,
)

agent = Agent(
    tools=[
        olostep_search,
        olostep_scrape,
        olostep_answers,
        olostep_map,
        olostep_crawl,
        olostep_get_crawl_results,
    ]
)

agent("Find the three most recent posts on the Olostep blog and summarize each one.")

Import only the tools you need — an agent that just answers questions may only want olostep_answers.

Tools

Picking the right tool

• Want a synthesized answer? Use olostep_answers. It searches, reads, and cross-validates, returning sources with the answer.
• Want a list of links to explore? Use olostep_search, then olostep_scrape the ones worth reading.
• Know the exact page? Go straight to olostep_scrape.
• Want a whole site or section? Use olostep_crawl, then olostep_get_crawl_results. Crawl both discovers and scrapes.
• Just want to see what URLs exist? Use olostep_map — discovery only, no scraping.

Notes

olostep_crawl is asynchronous. It returns a crawl id immediately and the job runs in the background — you must call olostep_get_crawl_results with that id to fetch pages. While the crawl is running, that tool reports progress so the agent knows to call again.

For JavaScript-heavy pages, pass wait_before_scraping (in milliseconds) to olostep_scrape:

olostep_scrape("https://example.com", wait_before_scraping=3000)

For geo-targeted content, pass a two-letter country code:

olostep_scrape("https://example.com", country="GB")

Error handling

Tools return an error result rather than raising, so a failed call doesn't break the agent loop:

{"status": "error", "content": [{"text": "Olostep API Error: 401 ..."}]}

A missing OLOSTEP_API_KEY produces a clear message pointing at the dashboard.

Development

pip install -e ".[dev]"
hatch run prepare   # format, lint, typecheck, test

Links

• Olostep documentation
• Olostep API reference
• Strands Agents documentation
• Issues

License

Apache 2.0 — see LICENSE.