Quick Start

Get started with Unbrowse in 5 minutes using the skills CLI.

1

Get an API key

Sign up at agent.unbrowse.ai and generate an API key.

2

Install the Unbrowse skill

Install Unbrowse from GitHub:

npx skills add https://github.com/getfoundry/unbrowse

Your assistant runtime should now expose Unbrowse tools.

Set UNBROWSE_API_KEY in the environment where skills runs.

3

Basic usage

Once installed, your AI assistant can use Unbrowse skills (abilities) through natural language:

Example: LinkedIn Post

You: "Post this announcement to LinkedIn with the image from my desktop"

AI Assistant:
[Uses Unbrowse to search for a "LinkedIn post with image" skill]
[Executes the skill with your content]
✅ Posted to LinkedIn: https://linkedin.com/feed/update/...

Example: Flight Search

You: "Find me flights from NYC to Tokyo between Jan 10-15, under $800"

AI Assistant:
[Uses Unbrowse to search flight skills]
[Executes searches across multiple airlines in parallel]

Found 12 flights:
1. Japan Airlines - $742 (1 stop, 14h 30m)
2. ANA - $780 (direct, 13h 50m)
3. United - $795 (2 stops, 18h 15m)
...

Example: Investment Research

You: "Get competitor traffic data for snowflake.com from SpyFu"

AI Assistant:
[Uses Unbrowse to execute SpyFu competitor search]

Traffic Analysis for snowflake.com:
- Monthly visits: 2.4M (↑15% vs last month)
- Organic keywords: 18,500
- Top competitors: Databricks, BigQuery, Redshift
- Traffic trend: Growing steadily

4

Available tools

The Unbrowse skill provides these tools to your AI assistant:

unbrowse_search

Search for available skills by natural language query.

Parameters:

• query (string): What you want to do (e.g., "book flight", "post to LinkedIn")

• limit (number, optional): Max results to return (default: 10)

Returns: List of matching skills with descriptions and parameters.

unbrowse_execute

Execute a specific skill.

Parameters:

• ability_id (string): ID of the ability to execute

• params (object): Parameters required by the ability

Returns: Structured result from the execution, plus trace metadata when available.

5

How it works behind the scenes

When your AI assistant uses Unbrowse:

6

Rate limits

Rate limits depend on your account and workload.

If you hit a limit:

• Reduce concurrency

• Cache and reuse ability IDs

• Retry with backoff

• Contact support for higher limits

7

Error handling

The Unbrowse skill returns structured error information:

AI Assistant: "Posting to LinkedIn..."

Error: Rate limit exceeded (100 executions/day limit reached)
Suggestion: Retry later or reduce concurrency

AI Assistant: "It looks like you've hit a limit. Want me to retry later?"

Common Use Cases

Social Media Management

"Post this update to LinkedIn and Twitter simultaneously"
"Schedule a thread on X for next Monday at 9am"

Travel Booking

"Find the cheapest flights to Paris next month"
"Book a hotel near Times Square for this weekend"

Data Research

"Get traffic stats for competitor.com from SimilarWeb"
"Pull company reviews from Glassdoor for DataCo"

Productivity

"Create a Jira ticket for this bug with high priority"
"Send this report to the #engineering Slack channel"

Next Steps

• SDK Documentation - Tools, environment variables, and advanced usage

• Integration Examples - More detailed examples

• API Reference - Complete API docs

• Authentication - Auth methods

---

Questions? Join our Discord