Getting Started

Overview

Wonda is the agentic browser for social media. Your agent drives it to work LinkedIn, Sales Navigator, X and Reddit through the CLI, MCP or this API.

What Wonda is

Wonda is a real browser on your computer, the Wonda Automation Browser, signed in to your LinkedIn, X and Reddit accounts. Your agent drives it to search, read your inbox, message and connect, exactly like you would by hand. You sign in yourself, so your agent never sees your password.

It works from Claude Code, Codex, Claude, ChatGPT, Cursor, OpenClaw and Hermes.

How your agent reaches it

Surface	How it connects	Who uses it
Wonda CLI	`wonda` commands in a terminal	Terminal agents: Claude Code, Codex, Cursor, OpenClaw and Hermes
MCP connector	`https://api.wondercat.ai/mcp`, approved with OAuth	Chat apps: Claude and ChatGPT
REST API	The endpoints in these docs, with an API key	Your own scripts and integrations

Whichever you use, actions run in the Wonda browser on your computer, signed in as you. Calls through the connector or the API reach it through the Wonda app, so keep the app running.

Get started

Join and install Wonda. Join, then run the install command from your account. It installs Wonda and signs you in.
bash
```
curl -fsSL https://wonda.sh/install.sh | bash -s -- <your code>
```
On Claude or ChatGPT, join, then download the Wonda app from your account and sign in.
Sign in to your accounts. Sign in to LinkedIn, X and Reddit once, in the Wonda browser. Your agent never sees your password.
bash
```
wonda wab login me linkedin
```
Ask your agent. Terminal agents run wonda for you. On Claude or ChatGPT, connect Wonda first: Claude, ChatGPT. The Quick Start walks through a first search.

What your agent can do

LinkedIn: search people, companies and posts, read and answer your messages, and send connection requests.
Sales Navigator: search leads with the filters you use: title, seniority, region, industry, company and more. Then save them to a list or send a connection request.
X: search posts, read your mentions and DMs, and reply.
Reddit: search posts, read threads and your inbox, and comment.

Every action, with its fields, is in the Action Reference. Running Platform Actions shows the request and response.

Base URL

https://api.wondercat.ai/api/v1

All endpoints are served under this base URL. The current API version is v1.

Request and response format

All JSON request bodies must include Content-Type: application/json.
All responses are JSON.
Dates are ISO 8601 strings.
IDs in path parameters are UUIDs unless the endpoint states otherwise.

Media and publishing

Wonda also has pay-as-you-go endpoints to generate and edit media and to publish it to connected Instagram and TikTok accounts. They are under Generation, Editing and Publishing in the sidebar.

These operations are asynchronous. When you submit work, the API returns a job ID immediately. Poll the matching job endpoint until the job reaches a terminal status.

Submit a request, such as POST /image/generate or POST /publish/instagram.
Poll GET /jobs/inference/{inferenceJobId} or GET /jobs/publish/{outputJobId} until status is "succeeded" or "failed".
Read output media or publish details from the completed job response.

Local CLI editing is different: wonda edit video, wonda edit image, and wonda edit audio render on your machine with ffmpeg or hyperframes and return the uploaded mediaId directly. The REST editing endpoints are retired and return 410 Gone with CLI migration hints.