SLBrow Browser Automation (Skills for Browser)

Skills for browser-side AI assistant. The browser plugin (aiassist) connects to slbrow-mcp via MCP protocol; these skills guide when and how to use the tools. Can be used via MCP tools or direct HTTP API calls with curl.

Prerequisites

1. SLBrow server running: npx slbrow or npm start in ai/slbrowmcp/slbrow-mcp/
2. Browser extension installed and connected (Chrome/Firefox)
3. MCP plugin enabled in aiassist: http://127.0.0.1:5556/mcp (视联浏览器MCP), http://127.0.0.1:5556/vaimcp (视联视频AI MCP)
4. Default ports: HTTP 5556, WebSocket 5555

Usage Methods

Method 1: MCP Tools (Browser Plugin + MCP)

When the MCP plugin is enabled, the AI has access to browser tools. Use these skills to guide tool selection and workflow:

• Navigation: Use page_navigate to open URLs
• Analysis: Use page_analyze with intent_hint (article, form submit, post_create) before extraction
• Tabs: Use tab_list first, then pass tab_id to target specific tabs

Method 2: HTTP API with curl (Direct Control)

Always available - Use curl commands to control browser directly without MCP plugin dependency:

Basic format (PowerShell-friendly — no temp JSON file):

curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{\"tool\":\"TOOL_NAME\",\"args\":{\"PARAM\":\"VALUE\"}}'

Important notes for Windows PowerShell:

• Use curl.exe instead of curl (PowerShell aliases curl to Invoke-WebRequest)
• Put the JSON body in -d '...' with single quotes around the whole argument; backslash-escape every double quote in the JSON (\"). That way the shell passes valid JSON to curl without needing --data-binary @file

Common curl examples:

# Create new tab and navigate
curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{\"tool\":\"tab_create\",\"args\":{\"url\":\"https://www.163.com\"}}'

# Navigate current tab
curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{\"tool\":\"page_navigate\",\"args\":{\"url\":\"https://www.example.com\"}}'

# List all tabs
curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{\"tool\":\"tab_list\",\"args\":{}}'

# Analyze page content
curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{\"tool\":\"page_analyze\",\"args\":{\"intent_hint\":\"article\"}}'

# Extract article content
curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{\"tool\":\"page_extract_content\",\"args\":{\"content_type\":\"article\"}}'

# Close specific tab
curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{\"tool\":\"tab_close\",\"args\":{\"tab_id\":1234567890}}'

# Search browser history
curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{\"tool\":\"get_history\",\"args\":{\"keywords\":\"search term\",\"max_results\":10}}'

Response format: API returns JSON with success, tool, result, and formatted fields for easy parsing.

Available Tools

VAI Tools (Seelink)

Workflow Patterns

Multi-tab workflow:

1. tab_list to get tab IDs
2. Add tab_id to any tool to target a background tab

Content extraction:

1. page_navigate to target URL
2. page_analyze with intent_hint to find elements
3. page_extract_content for article/search_results/posts

Form filling:

1. page_analyze with intent_hint "form submit" to discover form elements
2. Note the element IDs returned — use them with subsequent page_analyze or page_extract_content to confirm state

VAI (Seelink player AI):

1. get_page_seelink_player_list to get player IDs and count
2. Choose targets by player_position_list (zero-based index) or player_id_list (not both)
3. use_seelink_players_ai with chosen targets and ai_function_name
4. To apply different functions to different players, call use_seelink_players_ai separately for each
5. To disable AI on a player, set ai_function_name to "none"

Fetching Skills in Browser

The browser plugin can fetch skills from the server to inject into AI context:

GET http://127.0.0.1:5556/api/skills

Returns the full SKILL.md content (text/markdown). Use when slbrow MCP plugins are enabled to guide tool usage.

API Reference

For full parameter schemas, see references/api-reference.md.

Additional resources

• One-page workflow checklist: SKILL_COMPACT.md

Error Handling

• EXTENSION_DISCONNECTED: Ensure extension is installed and server is running. Check http://localhost:5556/health first.
• Tool call timeout: Operation took >30s; retry with simpler args or break into smaller steps.
• page_analyze returns 0 elements: Page may still be loading — wait a moment and retry, or page_navigate again.
• tab_id invalid (tab was closed): Call tab_list to refresh available tab IDs before retrying.
• Server restarted (session lost): Client will receive 404; re-initialize MCP connection (refresh the page).

Quick Reference for curl Commands

Tab Management:

• Create tab: tab_create with url parameter
• List tabs: tab_list with empty args
• Close tab: tab_close with tab_id parameter
• Navigate: page_navigate with url parameter

Content Analysis:

• Analyze page: page_analyze with intent_hint (article, form_submit, post_create)
• Extract content: page_extract_content with content_type (article, search_results, posts)
• Get links: get_page_links with link_type (all, internal, external)

History & Text:

• Search history: get_history with keywords, max_results
• Get selected text: get_selected_text with optional tab_id

Seelink AI:

• Get players: get_page_seelink_player_list
• Apply AI: use_seelink_players_ai with player_position_list or player_id_list and ai_function_name

Troubleshooting

Server not responding:

• Check if SLBrow server is running: curl.exe http://localhost:5556/health
• Verify server is started with npx slbrow or npm start

Curl command fails:

• Ensure using curl.exe in PowerShell
• For -d, use single-quoted JSON with \" around each JSON string delimiter (see Method 2 examples above)
• Verify server is accessible on port 5556

Tab operations not working:

• Use tab_list to get current tab IDs first
• Verify tab_id is valid and tab still exists
• Check if browser extension is connected