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