surf

Surf - VibeSurf Browser Automation

Overview

Control real browsers through VibeSurf. This skill delegates to specialized sub-skills.

🚨 VIBESURF STATUS (Auto-detected at session start)

Check the <SURF_SKILLS> status at the TOP of this context:

• ✅ Status: running → Proceed with surf skills
• ❌ Status: not_running → Ask user to run vibesurf (NEVER run it yourself)

Check manually: curl $VIBESURF_ENDPOINT/health (default: http://127.0.0.1:9335)

How to Call VibeSurf API

VibeSurf exposes three core HTTP endpoints. All requests go to the configured endpoint (check the status line above for the actual endpoint):

1. List Available Actions

GET $VIBESURF_ENDPOINT/api/tool/search?keyword={optional_keyword}

Returns all available VibeSurf actions.

2. Get Action Parameters

GET $VIBESURF_ENDPOINT/api/tool/{action_name}/params

Returns JSON schema for the action's parameters.

3. Execute Action

POST $VIBESURF_ENDPOINT/api/tool/execute
Content-Type: application/json

{
  "action_name": "action_name_here",
  "parameters": {
    // action-specific parameters
  }
}

Workflow:

1. Search for action → Get action name
2. Get params schema → See required/optional parameters
3. Execute → Call with parameters

⚠️ CRITICAL: Parameter Error Handling

ALWAYS call GET /api/tool/{action_name}/params before executing ANY action if you are unsure about parameters.

When you encounter a parameter error:

1. STOP - Do not guess or make up parameters
2. CALL GET /api/tool/{action_name}/params to get the exact schema
3. READ the response to identify required vs optional parameters
4. RETRY with correct parameters

Never blindly retry with incorrect parameters. Always fetch the schema first!

Which Skill to Use

Task Type	Use Skill	Action Name
AI web search	search	skill_search
Fetch URL content as markdown	fetch	skill_fetch
Extract lists/tables	js_code	skill_code
Extract page content	crawl	skill_crawl
Summarize page	summary	skill_summary
Stock/financial data	finance	skill_finance
Trending news	trend	skill_trend
Screenshot	screenshot	skill_screenshot
Precise browser control	browser	browser.* actions
Task-oriented automation (sub-agent)	browser-use	execute_browser_use_agent
Social Media Platform APIs	website-api	get_website_api_params, call_website_api
Pre-built workflows	workflows	search_workflows, execute_workflow
Gmail/GitHub/Slack	integrations	get_all_toolkit_types, execute_extra_tool
LLM profile settings	config-llm	config/llm-profiles/*
MCP server config	config-mcp	config/mcp-profiles/*
VibeSurf key/workflows	config-vibesurf	vibesurf/verify-key, vibesurf/import-workflow
Composio key/toolkits	config-composio	composio/verify-key, composio/toolkits
Schedule workflows	config-schedule	schedule/*
File upload/download	file	/api/files/*
Voice/ASR configuration	config-voice	/api/voices/*