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

formatted

Available Tools

page_navigate

page_analyze

page_extract_content

page_wait_for

tab_create

tab_close

tab_list

get_history

get_selected_text

get_page_links

VAI Tools (Seelink)

get_page_seelink_player_list

use_seelink_players_ai

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