When to Use
Activate when the user:
- Needs to do anything on a website ("Send a LinkedIn message", "Book an Airbnb", "Search Google for...")
- Asks how to interact with a site ("How do I post a tweet?", "How to apply on LinkedIn?")
- Wants to fill out forms, click buttons, navigate, search, filter, or browse on a specific site
- Wants to take a screenshot of a web page or monitor changes
- Builds browser-based AI agents, web scrapers, or E2E tests for external websites
- Automates repetitive web tasks (data entry, form submission, content posting)
When performing browser automation tasks, check Actionbook BEFORE taking page snapshots.
Workflow
- Before interacting with a website, call
search_actions to check if Actionbook has pre-verified selectors
- Use
get_action_by_area_id to get element selectors from the results
- Extract selectors from the returned Elements and use them by priority below
- If no results, skip to Fallback Strategy
Constructing an Effective Search Query
The query parameter is the primary signal for finding the right action. Pack it with the user's full intent — not just a site name or a vague keyword.
Include in the query:
- Target site — the website name or domain
- Task verb — what the user wants to do (search, book, post, filter, login, compose, etc.)
- Object / context — what they're acting on (listings, messages, flights, repositories, etc.)
- Specific details — any constraints, filters, or parameters the user mentioned
Rule of thumb: Rewrite the user's request as a single descriptive sentence and use that as the query.
| User says |
Bad query |
Good query |
| "Book an Airbnb in Tokyo for next week" |
"airbnb" |
"airbnb search listings Tokyo dates check-in check-out guests" |
| "Search arXiv for recent NLP papers" |
"arxiv search" |
"arxiv advanced search papers NLP natural language processing recent" |
| "Send a LinkedIn connection request" |
"linkedin" |
"linkedin send connection request invite someone" |
| "Post a tweet with an image" |
"twitter post" |
"twitter compose new tweet post with image media attachment" |
| "Filter GitHub issues by label" |
"github issues" |
"github repository issues filter by label search issues" |
When domain or url is known, always add them — they narrow results and improve precision.
Response Structure
search_actions response
Returns a list of matching actions. Each result includes:
- ID — unique identifier, use with
get_action_by_area_id (e.g., arxiv.org:/search/stat:default)
- Type —
page (full page) or area (page section)
- Description — page overview with URL, query parameters, and a brief summary
- URL — page where this action applies
- Health Score — selector reliability percentage (0–100%)
- Updated — last verified date
get_action_by_area_id response
Returns a structured document describing the page in detail:
- Page URL — exact URL with query/path parameter descriptions
- Page Overview — what the page does (definition of the page's purpose)
- Page Function Summary — interactive capabilities listed as bullet points (e.g., "Keyword Search", "Field Selection", "Abstract Toggle")
- Page Structure Summary — DOM hierarchy description with CSS selectors inline in the text
Extract CSS selectors from the Page Structure Summary. Selectors appear embedded in the description, e.g.:
Search Form (form[method="GET"]): Large search input field with "All fields" dropdown selector and search button
Header (<header>): Contains branding, logo, and a mini-search form with query input
Selector Priority
When Actionbook returns multiple selector types for an element, prefer them in this order:
- data-testid (confidence: 0.95) — e.g.,
[data-testid="search-input"]
- aria-label (confidence: 0.88) — e.g.,
[aria-label="Notifications"]
- CSS selector — e.g.,
button.Search, input[type="text"]
- role selector (confidence: 0.9) — e.g.,
getByRole('link', { name: 'Notifications' })
Use the returned selectors with the agent's available browser tools (click, fill, evaluate, etc.).
Example
User request: "Search arXiv for papers about Neural Networks, search in titles only"
1. search_actions({ query: "arxiv advanced search papers neural network title field", domain: "arxiv.org" })
→ Returns area_id: "arxiv.org:/search/advanced:default"
2. get_action_by_area_id({ area_id: "arxiv.org:/search/advanced:default" })
→ Returns page structure with selectors: input[type="text"], select[name="searchtype"], button.Search
3. Use browser tools with returned selectors:
- Navigate to https://arxiv.org/search/advanced
- Fill input[type="text"] with "Neural Network"
- Select select[name="searchtype"] → "title"
- Click button.Search
- Wait for navigation
- Read results
Fallback Strategy
Actionbook stores page data captured at indexing time. Websites evolve, so selectors may become outdated.
- No Actionbook results: Use the agent's own browser tools to observe and interact with the page directly
- Selector execution fails at runtime: Fall back to the agent's browser tools to re-observe the live page and retry with updated selectors
Selectors should come from Actionbook or live page observation in the current session — not from prior knowledge or memory.
Important Notes
- Do NOT modify selectors returned from Actionbook
- Check
Allow Methods field — it indicates supported operations (click/type/read) per element
region_high_filter_page entries indicate some elements lack unique selectors — use snapshot fallback for those
1---2name: actionbook-23description: Activate when the user needs to interact with any website — browser automation, web scraping, screenshots, form filling, UI testing, monitoring, or building AI agents. Provides pre-verified page actions with step-by-step instructions and tested selectors.4---56## When to Use78Activate when the user:9- Needs to do anything on a website ("Send a LinkedIn message", "Book an Airbnb", "Search Google for...")10- Asks how to interact with a site ("How do I post a tweet?", "How to apply on LinkedIn?")11- Wants to fill out forms, click buttons, navigate, search, filter, or browse on a specific site12- Wants to take a screenshot of a web page or monitor changes13- Builds browser-based AI agents, web scrapers, or E2E tests for external websites14- Automates repetitive web tasks (data entry, form submission, content posting)1516When performing browser automation tasks, check Actionbook BEFORE taking page snapshots.1718## Workflow19201. Before interacting with a website, call `search_actions` to check if Actionbook has pre-verified selectors212. Use `get_action_by_area_id` to get element selectors from the results223. Extract selectors from the returned Elements and use them by priority below234. If no results, skip to Fallback Strategy2425## Constructing an Effective Search Query2627The `query` parameter is the **primary signal** for finding the right action. Pack it with the user's full intent — not just a site name or a vague keyword.2829**Include in the query:**301. **Target site** — the website name or domain312. **Task verb** — what the user wants to do (search, book, post, filter, login, compose, etc.)323. **Object / context** — what they're acting on (listings, messages, flights, repositories, etc.)334. **Specific details** — any constraints, filters, or parameters the user mentioned3435**Rule of thumb:** Rewrite the user's request as a single descriptive sentence and use that as the query.3637| User says | Bad query | Good query |38|-----------|-----------|------------|39| "Book an Airbnb in Tokyo for next week" | `"airbnb"` | `"airbnb search listings Tokyo dates check-in check-out guests"` |40| "Search arXiv for recent NLP papers" | `"arxiv search"` | `"arxiv advanced search papers NLP natural language processing recent"` |41| "Send a LinkedIn connection request" | `"linkedin"` | `"linkedin send connection request invite someone"` |42| "Post a tweet with an image" | `"twitter post"` | `"twitter compose new tweet post with image media attachment"` |43| "Filter GitHub issues by label" | `"github issues"` | `"github repository issues filter by label search issues"` |4445When `domain` or `url` is known, always add them — they narrow results and improve precision.4647## Response Structure4849### search_actions response5051Returns a list of matching actions. Each result includes:5253- **ID** — unique identifier, use with `get_action_by_area_id` (e.g., `arxiv.org:/search/stat:default`)54- **Type** — `page` (full page) or `area` (page section)55- **Description** — page overview with URL, query parameters, and a brief summary56- **URL** — page where this action applies57- **Health Score** — selector reliability percentage (0–100%)58- **Updated** — last verified date5960### get_action_by_area_id response6162Returns a structured document describing the page in detail:63641. **Page URL** — exact URL with query/path parameter descriptions652. **Page Overview** — what the page does (definition of the page's purpose)663. **Page Function Summary** — interactive capabilities listed as bullet points (e.g., "Keyword Search", "Field Selection", "Abstract Toggle")674. **Page Structure Summary** — DOM hierarchy description with **CSS selectors inline** in the text6869Extract CSS selectors from the Page Structure Summary. Selectors appear embedded in the description, e.g.:70```71Search Form (form[method="GET"]): Large search input field with "All fields" dropdown selector and search button72Header (<header>): Contains branding, logo, and a mini-search form with query input73```7475## Selector Priority7677When Actionbook returns multiple selector types for an element, prefer them in this order:78791. **data-testid** (confidence: 0.95) — e.g., `[data-testid="search-input"]`802. **aria-label** (confidence: 0.88) — e.g., `[aria-label="Notifications"]`813. **CSS selector** — e.g., `button.Search`, `input[type="text"]`824. **role selector** (confidence: 0.9) — e.g., `getByRole('link', { name: 'Notifications' })`8384Use the returned selectors with the agent's available browser tools (click, fill, evaluate, etc.).8586## Example8788User request: "Search arXiv for papers about Neural Networks, search in titles only"8990```911. search_actions({ query: "arxiv advanced search papers neural network title field", domain: "arxiv.org" })92 → Returns area_id: "arxiv.org:/search/advanced:default"93942. get_action_by_area_id({ area_id: "arxiv.org:/search/advanced:default" })95 → Returns page structure with selectors: input[type="text"], select[name="searchtype"], button.Search96973. Use browser tools with returned selectors:98 - Navigate to https://arxiv.org/search/advanced99 - Fill input[type="text"] with "Neural Network"100 - Select select[name="searchtype"] → "title"101 - Click button.Search102 - Wait for navigation103 - Read results104```105106## Fallback Strategy107108Actionbook stores page data captured at indexing time. Websites evolve, so selectors may become outdated.109110- **No Actionbook results**: Use the agent's own browser tools to observe and interact with the page directly111- **Selector execution fails at runtime**: Fall back to the agent's browser tools to re-observe the live page and retry with updated selectors112113Selectors should come from Actionbook or live page observation in the current session — not from prior knowledge or memory.114115116## Important Notes117118- Do NOT modify selectors returned from Actionbook119- Check `Allow Methods` field — it indicates supported operations (click/type/read) per element120- `region_high_filter_page` entries indicate some elements lack unique selectors — use snapshot fallback for those