Skip to main content

Browser Extension Quick Start

Run workflows and chat with agents using page context.

What You'll Learn​

  • Install and authenticate the extension
  • Run workflows with page data
  • Chat with agents about any webpage
  • Use screenshots and page content

Step 1: Install the Extension​

  1. Open Chrome Web Store
  2. Search for "FlowMaestro"
  3. Click Add to Chrome
  4. Confirm the installation

The FlowMaestro icon appears in your toolbar.

Step 2: Authenticate​

  1. Click the FlowMaestro icon
  2. Click Sign In
  3. Enter your FlowMaestro credentials
  4. Authorize the extension

You're now connected to your workspace.

Step 3: Run Your First Workflow​

Select a Workflow​

  1. Click the extension icon
  2. Go to the Workflows tab
  3. Browse or search for a workflow
  4. Click to select it

Include Page Context​

Toggle what to include:

OptionDescription
URLCurrent page URL
TitlePage title
ContentExtracted text content
ScreenshotVisible viewport capture
MetadataOpen Graph, meta tags

Execute​

  1. Fill in any additional inputs
  2. Click Run Workflow
  3. View results in the panel

Step 4: Chat with an Agent​

Start a Conversation​

  1. Click the extension icon
  2. Go to the Agents tab
  3. Select an agent
  4. Type your message

Use Page Context​

The agent automatically sees:

I'm looking at: https://example.com/product/123
Page title: Product Details - Widget Pro

[You can ask me about this page]

Example conversation:

You: Summarize this product page

Agent: This page describes Widget Pro, a productivity tool with:
- Real-time collaboration
- 50+ integrations
- Enterprise security
- Starting at $10/month

Key features highlighted are the API access and
custom workflow builder.

Use Cases​

Research & Analysis​

You: What are the main points in this article?

Agent: [Analyzes page content]
The article discusses three main topics:
1. Market trends in AI adoption
2. Challenges for enterprise implementation
3. Recommended best practices

Key statistics mentioned: 67% adoption rate,
3x productivity gains...

Data Extraction​

Run a workflow to extract structured data:

// Workflow extracts from page
{
trigger: "extension",
inputs: {
pageContent: "{{extension.content}}",
pageUrl: "{{extension.url}}"
},
// Outputs structured JSON
}

Content Generation​

You: Write a tweet thread about this blog post

Agent: [Reads page content]
Here's a thread:

1/ Just read an insightful post on RAG systems...
2/ Key insight: Chunking strategy matters more than model choice...
3/ The author recommends starting with 1000-char chunks...

Competitive Analysis​

You: How does this pricing compare to our product?

Agent: [Accesses page and your knowledge base]
Comparing to your pricing:

| Feature | This Page | Your Product |
|---------|-----------|--------------|
| Base price | $29/mo | $25/mo |
| Users | 5 | 10 |
| Storage | 10GB | 25GB |

Your product offers better value on storage and
user seats...

Page Context Details​

What's Captured​

When you enable page context, the extension extracts:

DataDescription
URLFull page URL
TitleDocument title
Meta tagsDescription, keywords, OG tags
HeadingsH1-H6 hierarchy
Text contentMain body text
TablesStructured table data
ListsBullet and numbered lists
LinksAnchor text and URLs

Screenshot Capture​

Screenshots capture:

  • Visible viewport only
  • Current scroll position
  • Rendered state (after JS)

Use for:

  • Visual analysis
  • Design review
  • Error documentation

Privacy​

  • Data sent only when you trigger action
  • Not captured while browsing
  • No persistent storage
  • Respects page robots.txt

Workflow Integration​

Mapping Extension Data​

In your workflow, access extension data:

{
// Page URL
pageUrl: "{{trigger.extension.url}}",

// Page title
pageTitle: "{{trigger.extension.title}}",

// Extracted text
pageContent: "{{trigger.extension.content}}",

// Screenshot (base64)
screenshot: "{{trigger.extension.screenshot}}",

// Metadata
metadata: "{{trigger.extension.metadata}}"
}

Example: Lead Enrichment​

  1. Visit a LinkedIn profile
  2. Click extension > Select "Lead Enrichment" workflow
  3. Workflow extracts name, company, role
  4. Creates/updates contact in HubSpot

Example: Bug Report​

  1. Encounter a bug on your app
  2. Click extension > Select "Bug Report" workflow
  3. Screenshot + URL automatically captured
  4. Creates Jira ticket with context

Settings​

Access extension settings:

  1. Click extension icon
  2. Click gear icon

Options​

SettingDescription
Default agentAgent to open by default
Auto-captureWhat to capture automatically
Keyboard shortcutQuick access hotkey
ThemeLight/dark/system

Keyboard Shortcuts​

ShortcutAction
Ctrl+Shift+FOpen extension
Ctrl+Shift+SCapture screenshot
Ctrl+Shift+RRun last workflow

Customize in Chrome: chrome://extensions/shortcuts

Troubleshooting​

IssueSolution
Extension not loadingRefresh page, check permissions
"Not authenticated"Click sign in, re-authorize
Page content emptySome sites block extraction
Screenshot blankTry scrolling, wait for load
Workflow not foundCheck workspace permissions

Site Restrictions​

Some sites block content extraction:

  • Banking and financial sites
  • Sites with strict CSP
  • Paywalled content

For these, use screenshot capture instead.

Next Steps​