Flow Table Extractor

For EndChrome Users

This Chromestep-by-step extensionguide extractsshows tablesyou fromhow websitesto install and uploadsuse them tothe Flow Immersive,Table withExtractor optional Claude AI smart parsing for complex tables.extension.

✨ Key

📥 Features

🔍 Automatically detects all tables on any webpage 📊 One-click extraction and upload to Flow 🤖 Optional Claude AI smart parsing for multi-row headers 🔐 Secure credential storageInstallation (enterOne-Time once, use everywhere) 🔄 Dataset versioning (same title = new version) Setup)

🚀 Quick Start (5 Minutes)

Step 1: Download the Extension

Download flow-table-extractor.zip Unzip the file to a folder on your computer Remember where you saved it!

Step 2: Install Browserin Extension

Chrome

Open Chrome Extensions Page:

1. Open Chrome andbrowser

goType toin address bar: chrome://extensions/ Press Enter

 → Extensions → Manage Extensions)

Enable Developer Mode:

Look at the top-right corner Find the toggle switch "Developer mode" Turn it ON (toggleit inshould top-right)turn blue)

Load the Extension:

1. Click "Load unpacked" button (top-left)
2. SelectNavigate to the flow-table-extractor folder you unzipped
3. LookClick for"Select Folder"

Success!

You should see the Flow Table Extractor card appear:

Green "FT" icon Name: "Flow Table Extractor" Status: ON (blue toggle)

Step 3: Pin the Extension (Recommended)

Click the puzzle piece icon (🧩) in Chrome toolbar Find "Flow Table Extractor" Click the pin icon (📌) next to it The green "FT" icon will now appear in your toolbar

---

⚙️ Configuration (One-Time Setup)

Step 4: Configure Your Credentials

Open the Extension:

Click the green "FT" icon in your Chrome toolbar The Flow Table Extractor popup opens

Step 2:

Configure Credentials (One Time!)Credentials:

1. Click the "FT"button: extension icon

Click "Configure Flow Credentials" A form appears with three fields

Fill in the Form:

┌─────────────────────────────────────┐
│ Flow Username:                      │
│ [your-flow-username____________]    │
│                                     │
│ Flow Password:                      │
│ [••••••••••••••••••••••••••]       │
│                                     │
│ Claude API Key (optional):          │
│ [sk-ant-api-key-here__________]    │
│ For smart table parsing...          │
│                                     │
│ [Save All Credentials]              │
│ [Cancel]                            │
└─────────────────────────────────────┘

Field 1: Flow Username

• Enter your Flow Immersive username

andUse your USERNAME, not email Example: john (not john@company.com)

Field 2: Flow Password

Enter your Flow Immersive password This is the password you use to login at a.flow.gl

Field 3: Claude API Key (Optional)

Enter

Leave blank if you don't have one Or enter your Claude API key for smart table parsing Example: sk-ant-api03-abc123... Get one at: https://console.anthropic.com/

Save:

Click "Save All Credentials" Done!You Nevershould see: "✓ All credentials saved securely!" Credentials are saved and you'll never need to enter againthem ✓

Step 3: Extract Your First Table

Go to any website with tables (try Wikipedia!) Click the "FT" extension icon Select a table from the dropdown Enter a dataset title Click "Extract & Upload to Flow" Check Flow to see your data!again!

🔐What Securityis &Claude PrivacyAPI Key?

WhereClaude areAI credentialshelps stored?parse complex tables with:

Multi-row headers Merged cells Nested structures

Do you need it?

• Browser:❌ Chrome'sNo encrypted- syncfor storagesimple tables (most tables)
• Backend:✓ LocalYes file (~/.flow_extractor_config.json) with restricted permissions

Is it secure?

✅ Chrome automatically encrypts stored credentials ✅ File permissions prevent other users from reading ✅ Communication is localhost-only or HTTPS ✅ No third-party access to your credentials

See SECURITY.md- for detailed information.

🤖 Claude AI Smart Parsing (Optional)

ForWikipedia-style complex tables

✓ Yes - for financial reports with multi-rowgrouped headers (like Wikipedia population tables), enable Claude AI:

Setup:

Get API key from https://console.anthropic.com/columns Enter it in "Configure Flow Credentials" (or set as environment variable) Check ☑️ "Use Claude AI for smart table parsing"

Cost: ~$0.01-0.03 per table (1-3 cents)

WhatHow itto does:get one:

Go to https://console.anthropic.com/ Sign up (free) Go to "API Keys" Click "Create Key" Copy the key (starts with sk-ant-) Paste into the extension

---

🚀 Using the Extension

Step 5: Navigate to a Page with Tables

Examples of good pages:

• IntelligentlyWikipedia combinesdata multi-row headerstables
• HandlesFinancial merged cells properlyreports
• CreatesProduct clearcomparison column namespages
• PerfectAny forpage complexwith Wikipedia/financialHTML tables

See CLAUDE_SETUP.md for details.Example:

📖 Documentation

START_HERE.md - Welcome guide QUICKSTART.md - 5-minute setup SECURITY.md - Credential storage explained CLAUDE_SETUP.md - Claude AI setup README.md - Complete documentation VISUAL_GUIDE.md - Step-by-step walkthrough

🧪 Test Files

test-page.html - Simple tables for testing test-complex-tables.html - Complex multi-row header tables

💡 Tips

1. DescriptiveGo titles:to Use clear dataset names like "Q4 Sales 2024"Wikipedia
2. VersionSearch control:for Re-upload"List of countries by population"

You'll see tables with same title creates new versiondata

Step 6: Open the Extension

Click the green Claude"FT" foricon complex:in Onlyyour usetoolbar.

The popup shows:

┌─────────────────────────────────────────┐
│ [FLOW] Table Extractor    [📖 Docs]    │
├─────────────────────────────────────────┤
│                                         │
│  Select Table: [Table 1: Country... ▼] │
│  3 table(s) found                       │
│                                         │
│  Dataset Title: [My Dataset_______]    │
│                                         │
│  ☐ Use Claude AI for multi-rowsmart headerparsing     tables

│ Keep│ backend│ running:│ Leave[Extract python& server.pyUpload to Flow] │ │ [Configure Flow Credentials] │ │ │ ├─────────────────────────────────────────┤ │ Flow Immersive, Inc. │ └─────────────────────────────────────────┘ running in background

🐛Step Troubleshooting7: Select a Table

"ConnectionTable error: Failed to fetch"Dropdown: → Backend isn't running. Start python server.py

"Flow

credentialsShows not configured" → Click "Configure Flow Credentials" and save them

"Noall tables found on thisthe page"page Preview format: "Table 1: FirstColumn, SecondColumn... (X rows)" Click dropdown to see all available tables Select the table you want to extract

No tables found?

→

PageThe page doesn't have HTML <table> elements Try a different page

Step 8: Enter Dataset Title

In the "Dataset Title" field:

Enter a descriptive name for your data Examples:

Country Population 2024 Q4 Sales Data Product Comparison Make it clear and memorable!

Version Control:

If you use the same title again, Flow creates a new version Useful for tracking changes over time

Step 9: Choose Parsing Mode (Optional)

Checkbox: "Use Claude AI for smart table parsing"

TablesWhen extractedto incorrectlycheck this box:

→

Try☑️ enablingTable "has multi-row headers ☑️ Table has merged cells ☑️ Complex Wikipedia-style tables ☑️ Financial reports with nested columns

When to leave unchecked:

☐ Simple tables (one header row) ☐ You don't have a Claude AIAPI smartkey parsing"☐ forYou complexwant fastest extraction

Example tables that need Claude:

Simple table (no Claude needed):
┌──────────┬──────────┬──────────┐
│ Country  │ Population│ Area    │
├──────────┼──────────┼──────────┤
│ USA      │ 331M     │ 9.8M    │
└──────────┴──────────┴──────────┘

Complex table (use Claude):
┌──────────┬──────────────────────┐
│ Country  │     Statistics       │
│          ├──────────┬───────────┤
│          │ 2023     │ 2024      │
│          ├────┬─────┼────┬──────┤
│          │Pop │Area │Pop │Area  │
├──────────┼────┼─────┼────┼──────┤
│ USA      │331M│9.8M │334M│9.8M  │
└──────────┴────┴─────┴────┴──────┘

Step 10: Extract!

Click the big green button: "Extract & Upload to Flow"

MoreWhat helphappens:

Status message appears:

Without Claude: "Uploading to Flow..." With Claude: "Analyzing table with Claude AI..."

Processing time:

Simple tables: 2-5 seconds With Claude AI: 5-10 seconds

Success message:

✓ Success! Uploaded 150 rows to Flow 
dataset "Country Population 2024"

Error message (if something goes wrong):

See

🔐 Flow Authentication Failed

Details: Invalid username or checkpassword.

💡 Suggestion: Update your Flow credentials 
in "Configure Flow Credentials".

Step 11: View in Flow

Go to Flow Immersive (a.flow.gl) Navigate to a Flow and your datasets via the terminalManage outputDatasets button Find the dataset by the title you entered

---

💡 Tips & Tricks

📊Tip Usage1: ExamplesTest Your Credentials

If you're getting authentication errors:

WikipediaQuick Data:Test:

1. Go to "List of countries by population"a.flow.gl
2. EnableTry Claudelogging AIin with your credentials

If it works there but not in the extension:

Make sure you're using USERNAME (multi-rownot headers!)email) Re-enter credentials in the extension

Tip 2: Documentation Button

Click the blue "📖 Docs" button in the extension header to:

Read detailed documentation See troubleshooting guides Learn advanced features

Tip 3: Multiple Tables

If a page has many tables:

1. Extract →them Uploadone toat Flowa time
2. AnalyzeUse indifferent Flow!dataset titles

Or use the same title for versions

Tip 4: Complex Tables

Wikipedia tables often have complex structures:

Check "Use Claude AI" Takes a bit longer Much better results!

YourExample: Company"List Dashboard:of largest companies" on Wikipedia

---

🔧 Troubleshooting

Problem: "Cannot connect to backend server"

Solution: The backend server is hosted and should always be running. If you see this error:

1. OpenWait dashboarda withmoment dataand tablestry again
2. SelectCheck tableyour internet connection
3. Upload toContact Flow forif analysis

problem

Financial Reports:

Find tables on investor sites Enable Claude for grouped columns Extract clean datapersists

🔄Problem: Updates"Flow Authentication Failed"

ToCause: updateWrong credentials:username or password

Solution:

Click extension icon Click "Configure Flow Credentials" UpdateMake anysure fieldyou're using:

USERNAME (not email) Correct password Test login at flowimmersive.com first Re-enter credentials and save

Problem: Claude AI checkbox is grayed out

Cause: No Claude API key configured

Solution:

Click "Configure Flow Credentials" Add your Claude API key Save Checkbox will become available

Problem: Upload is slow

ToNormal add/changespeeds:

Simple tables: 2-5 seconds Claude AI parsing: 5-10 seconds Very large tables: up to 30 seconds

If slower:

Check your internet connection Wait for timeout message Try again

---

📖 Common Workflows

Workflow 1: Quick Wikipedia Data Extract

Go to Wikipedia article with data Click "FT" icon Select table from dropdown Enter title: Wikipedia - [Topic Name] Leave Claude unchecked (try it first) Click "Extract & Upload to Flow" If table looks messy in Flow:

Try again with "Use Claude AI" checked

Workflow 2: Complex Financial Table

Navigate to financial report website Find the data table Click "FT" icon Select table Enter title: Q4 2024 Financial Report ✓ Check "Use Claude AI" (complex table!) Click "Extract & Upload to Flow" Wait 5-10 seconds View perfectly formatted data in Flow!

Workflow 3: Regular Data Updates

Same dataset, multiple versions:

Extract table from website Use same dataset title each time Example: Weekly Sales Report Flow creates new version automatically Track changes over time!

---

✅ Setup Checklist

Before using the extension:

Downloaded and unzipped extension Installed in Chrome (chrome://extensions/) Enabled Developer mode Pinned extension to toolbar Configured Flow credentials (Optional) Added Claude API key: Same as above - it's in the credentials form.

🎯 System Requirements

Browser: Chrome, Edge, or Bravekey OS:Tested Windows,on Mac,a orsimple Linux Internet: Required for Flow uploads and Claude AItable

You're ready to extract tables! 🎉

---

🎓 Pro User Tips

Dataset Organization

Use consistent naming:

Company - Data Type - Date Example: Acme Corp - Sales - 2024-Q4

Claude AI Usage

Save money:

Try without Claude first If table is messy → Use Claude Simple tables don't need it!

Version Control

Track data over time:

Use same title weekly/monthly Flow creates versions automatically Compare changes in Flow

---

EnjoyHappy smartTable table extraction!Extracting! 🚀📊✨