Stagehand + X (Twitter)

What is Stagehand?

Browserbase's TypeScript framework for building reliable web-automation agents with natural-language page actions. Use Scavio to find the right pages before handing off to Stagehand.

Searching X (Twitter) with Stagehand

This integration lets your Stagehand agent search X (Twitter) in real time via the Scavio API. The agent gets back structured JSON with post snippets, author handles, timestamps, engagement signals — ready for reasoning and decision-making.

Setup

npm install @browserbasehq/stagehand

Code Example

Here is a complete Stagehand agent that searches X (Twitter) using Scavio:

# Generic HTTP integration for Stagehand
# Use your framework's HTTP request tool to call:
# POST https://api.scavio.dev/api/v1/search
# Header: x-api-key: your_scavio_api_key
# Body: {"query": "your search query"}

Full Working Example

A production-ready example with error handling:

# Generic HTTP integration for Stagehand
# Use your framework's HTTP request tool to call:
# POST https://api.scavio.dev/api/v1/search
# Header: x-api-key: your_scavio_api_key
# Body: {"query": "your search query"}

Pricing

Scavio offers a free tier with 500 credits/month (1 credit per search). No credit card required. This is enough to build and test your Stagehand integration. Paid plans start at $30/month for higher volumes.