curl -X POST https://win.oneshotagent.com/v1/tools/browser \
  -H "Content-Type: application/json" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -d '{
    "task": "Go to producthunt.com, find the top 5 AI products launched today, and extract their names, descriptions, and upvote counts",
    "output_schema": {
      "products": [{
        "name": "string",
        "description": "string",
        "upvotes": "number"
      }]
    }
  }'

import { OneShot } from "@oneshot-agent/sdk";

const agent = new OneShot({ privateKey: process.env.AGENT_PRIVATE_KEY });

const result = await agent.browser({
  task: "Go to producthunt.com, find the top 5 AI products launched today, and extract their names, descriptions, and upvote counts",
  output_schema: {
    products: [{
      name: "string",
      description: "string",
      upvotes: "number"
    }]
  }
});

console.log("Products:", result.output.products);
console.log("Steps taken:", result.steps.length);

import { OneShot } from "@oneshot-agent/sdk";

const agent = new OneShot({ privateKey: process.env.AGENT_PRIVATE_KEY });

// Import cookies/localStorage exported from your own signed-in browser.
const profile = await agent.createBrowserProfile("my-github-bot", { storage_state: state });

// Reuse the imported profile
const result = await agent.browser({
  task: "Go to github.com/notifications and list my unread notifications",
  profile_id: profile.id,
  allowed_domains: ["github.com"],
});

from oneshot import OneShotClient

client = OneShotClient(private_key="0x...")

# Create a persistent profile
profile = client.create_browser_profile("my-github-bot", storage_state=state)

# Use the profile with credentials
result = client.browser(
    task="Go to github.com/notifications and list my unread notifications",
    profile_id=profile["id"],
    allowed_domains=["github.com"],
)

{
  "error": "payment_required",
  "message": "Payment required for browser automation.",
  "payment_request": {
    "chain_id": 8453,
    "token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "0.150000",
    "recipient": "0x..."
  },
  "context": {
    "tool": "browser",
    "quote_id": "quote_abc123",
    "task_summary": "Navigate to ProductHunt, find top AI products, extract structured data",
    "estimated_steps": 8,
    "max_steps": 25,
    "estimated_cost": "0.150000",
    "complexity_score": 0.6,
    "expires_at": "2026-01-15T12:30:00Z"
  }
}

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "tool": "browser",
  "message": "Browser task initiated. Results available at /v1/requests/{id}.",
  "idempotency_key": "quote:quote_01HXAMPLE",
  "browser": {
    "estimated_steps": 8,
    "max_steps": 25,
    "estimated_cost": "0.150000"
  }
}

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "result": {
    "output": {
      "products": [
        { "name": "AgentKit", "description": "Build autonomous AI agents in minutes", "upvotes": 342 },
        { "name": "VoiceFlow", "description": "AI voice agents for customer support", "upvotes": 289 }
      ]
    },
    "steps": [
      { "number": 1, "goal": "Navigate to producthunt.com", "url": "https://www.producthunt.com" },
      { "number": 2, "goal": "Find AI products section", "url": "https://www.producthunt.com/topics/artificial-intelligence" }
    ],
    "cost": 0.12
  }
}