# Send Nextbrowser to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "next-browser",
    "name": "Nextbrowser",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/highxshell/next-browser",
    "canonicalUrl": "https://clawhub.ai/highxshell/next-browser",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/next-browser",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=next-browser",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "next-browser",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-06T03:02:33.530Z",
      "expiresAt": "2026-05-13T03:02:33.530Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=next-browser",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=next-browser",
        "contentDisposition": "attachment; filename=\"next-browser-1.0.22.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "next-browser"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/next-browser"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/next-browser",
    "downloadUrl": "https://openagent3.xyz/downloads/next-browser",
    "agentUrl": "https://openagent3.xyz/skills/next-browser/agent",
    "manifestUrl": "https://openagent3.xyz/skills/next-browser/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/next-browser/agent.md"
  }
}
```
## Documentation

### Nextbrowser

Nextbrowser provides cloud browsers and autonomous browser automation via API.

Docs:

Cloud API: https://docs.nextbrowser.com/getting-started

### Setup

API Key is read from openclaw config at skills.entries.next-browser.apiKey.

If not configured, tell the user:

To use Nextbrowser, you need an API key. Get one at https://app.nextbrowser.com/user-settings (new signups get 2000 free credits). Then configure it:
openclaw config set skills.entries.next-browser.apiKey "YOUR_API_KEY"

Important: Nextbrowser API keys can have various formats and prefixes.
Do NOT validate the key format yourself - simply use whatever key the user provides. If the key is invalid, the API will return an authentication error, and only then should you ask the user to verify their key.

Base URL: https://app.nextbrowser.com/api/v1

All requests need header: Authorization: x-api-key <apiKey>

### 1. Credentials Manager

The Credentials Manager securely stores and reuses authentication data across browser runs and autonomous tasks.

# List credentials
curl "https://app.nextbrowser.com/api/v1/users/credentials" -H "Authorization: x-api-key $API_KEY"

### 2. Profiles

Profiles persist cookies and login state across browser sessions. Create one, log into your accounts in the browser, and reuse it.

# List profiles
curl "https://app.nextbrowser.com/api/v1/browser/profiles" -H "Authorization: x-api-key $API_KEY"

# Create browser profile
curl -X POST "https://app.nextbrowser.com/api/v1/browser/profiles" \\
  -H "Authorization: x-api-key $API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"name": "<profile-name>", "browser_settings": {"os_type": "<os-type>", "browser_type": "chrome"},
   "proxy_settings":{"protocol":"<http|https|socks5>","country":"<iso-2-country-code>","mode":"built-in"},
   "credentials": ["<credential-id>"]}'

# Delete profile
curl -X DELETE "https://app.nextbrowser.com/api/v1/browser/profiles/<profile-id>" \\
  -H "Authorization: x-api-key $API_KEY"

### 3. Locations

The Locations endpoints provide available geolocation metadata for proxy and browser configuration. Use them to dynamically discover supported countries, regions, cities, and ISPs before creating profiles or running tasks under specific network conditions.

# List Countries
curl "https://app.nextbrowser.com/api/v1/location/countries?\\
limit=<limit>&\\
offset=<offset>&\\
name=<name>&\\
code=<iso2-code>&\\
connection_type=<connection-type>" \\
  -H "Authorization: x-api-key $API_KEY"

# List Regions
curl "https://app.nextbrowser.com/api/v1/location/regions?\\
country__code=<iso2-country>&\\
limit=<limit>&\\
offset=<offset>&\\
name=<name>&\\
code=<region-code>&\\
city__code=<city-code>&\\
connection_type=<connection-type>" \\
  -H "Authorization: x-api-key $API_KEY"

# List Cities
curl "https://app.nextbrowser.com/api/v1/location/cities?\\
country__code=<iso2-country>&\\
limit=<limit>&\\
offset=<offset>&\\
name=<name>&\\
code=<city-code>&\\
region__code=<region-code>&\\
connection_type=<connection-type>" \\
  -H "Authorization: x-api-key $API_KEY"

# List ISPs
curl "https://app.nextbrowser.com/api/v1/location/isps?\\
country__code=<iso2-country>&\\
limit=<limit>&\\
offset=<offset>&\\
name=<name>&\\
code=<isp-code>&\\
region__code=<region-code>&\\
city__code=<city-code>&\\
connection_type=<connection-type>" \\
  -H "Authorization: x-api-key $API_KEY"

### 4. Tasks (Subagent)

Run autonomous browser tasks - like a subagent that handles browser interactions for you. Give it a prompt and it completes the task.

Always use fast mode - optimized for browser tasks, 3-5x faster than other models.
Always use true for skip_plan_approval - optimized for automated tasks, skips the approval and improve performance.

curl -X POST "https://app.nextbrowser.com/api/v1/chat/tasks" \\
  -H "Authorization: x-api-key $API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "task_description": "'"\\
Go to Reddit.com account, check if the account is logged in (if not, use credentials stored). \\
Find 10 relevant posts on the topic of AI Agents, upvote 8 of them and post 3 witty-sounding comments \\
that a cynical and funny Reddit user would post. Ensure that the comment is posted, ask for approval \\
if you are not sure whether such comment is okay. By the end, you should have at least 10 relevant posts \\
viewed, 8 upvotes, and 3 comments."\\
"'",
    "mode": "fast",
    "profile_id": "<profile-id>",
    "skip_plan_approval": true,
    "send_email_notification": false
  }'

### Endpoint: Stop chat session and task

The chat-session-id is returned in the response of - POST /api/v1/chat/tasks

curl -X PUT "https://app.nextbrowser.com/api/v1/chat/sessions/<chat-session-id>/stop" \\
  -H "Authorization: x-api-key $API_KEY"

### Endpoint: Poll for completion

curl "https://app.nextbrowser.com/api/v1/chat/tasks/<task-id>" \\
  -H "Authorization: x-api-key $API_KEY"

curl "https://app.nextbrowser.com/api/v1/chat/tasks/<task-id>?from_step=3" \\
  -H "Authorization: x-api-key $API_KEY"

Query params (optional):

from_step: integer >= 1. First step index to return. Defaults to 1 if missing/invalid. Use this parameter to poll only new steps.

### Response

{
  "success": true,
  "payload": {
    "status": "finished",
    "output": "Task completed. 10 relevant posts are viewed, 8 upvotes are done and 3 comments posted.",
    "isSuccess": true,
    "steps": [
      {
        "created_at": "2025-01-01T10:00:00Z",
        "finished_at": "2025-01-01T10:00:05Z",
        "description": "Opened Reddit search page",
        "status": "completed",
        "step_number": 1
      }
      // ... more steps starting from from_step
    ],
    "total_steps": 5
  },
  "errors": {},
  "description": "Task retrieved successfully"
}

### Field semantics

status: high-level task status: "processing" | "finished" | "failed".
output: final task output (if available).
isSuccess: true if task finished successfully, otherwise false.
steps: list of task steps starting from from_step (or from 1 by default).
step_number: sequential number of the step within the task, always starting at 1 in this array.
total_steps: total number of steps the task has, independent of from_step.

### Task options

OptionDescriptiontask_descriptionYour prompt (required)modeAlways use fastprofile_idUse a profile for authskip_plan_approvalAlways use truesend_email_notificationIf true, a completion email will be sent for the task.

### Full API Reference

See references/api.md for all endpoints including Sessions, Files, Skills, and Skills Marketplace.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: highxshell
- Version: 1.0.14
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-06T03:02:33.530Z
- Expires at: 2026-05-13T03:02:33.530Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/next-browser)
- [Send to Agent page](https://openagent3.xyz/skills/next-browser/agent)
- [JSON manifest](https://openagent3.xyz/skills/next-browser/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/next-browser/agent.md)
- [Download page](https://openagent3.xyz/downloads/next-browser)