User Manual

Go to the app's home page. You'll see two tabs at the top:

• User Agent Test — This is what you want. It tests URLs against different visitors.
• Screaming Frog Upload — For advanced crawl analysis (skip this for now).

Stay on the User Agent Test tab.

Paste a single URL into the input field. Use a page you know well — your homepage is a great first choice.

Make sure it starts with https:// (or http://).

Below the URL input you'll see a list of user agents with checkboxes. Don't overthink this — use a Quick Preset instead:

Click a preset button and the right agents are selected for you.

Click the Run Test button. A progress bar will appear showing each visitor testing the page.

This usually takes 30 seconds to 2 minutes depending on how many visitors you selected.

When the test finishes, you'll see:

• A score (0–100) summarizing the page's SEO health
• A link to the comparison report showing screenshots and metadata side by side
• A Download button for the full export ZIP

Click the report link to dive in, or head to the Dashboard to see all your past runs.

1. Select the user agents you want.
2. Enter a name in the Preset name field.
3. Click Save Preset.
4. Your preset appears below the form as a clickable chip.
5. Click the chip to re-apply it later.
6. To remove a saved preset, click the × on that chip.

1. Create a spreadsheet with your URLs in the first column (one URL per row).
2. Save it as a .csv file.
3. In the Workspace, click the CSV Upload area and select your file.
4. Pick a Quick Preset (or select agents manually).
5. Click Run Test.

The tool will test every URL in your file. Results for each URL appear on the Dashboard.

You start at 100 points and lose points for each issue found:

• High severity issue = minus 25 points (e.g., page is blocked from indexing)
• Medium severity issue = minus 10 points (e.g., missing meta description)
• Low severity issue = minus 5 points (e.g., images missing alt text)

The minimum score is 0. The more issues found, the lower the score.

The tool checks for:

• HTTP errors (404, 500, etc.)
• noindex tags telling search engines to stay away
• Redirect chains (too many redirects in a row)
• Canonical URL problems (pointing search engines to the wrong page)

Why it matters: If search engines can't index your page, it won't appear in search results — no matter how great the content is.

The tool compares what different visitors see side by side:

• Does Google's bot see the same title as a real browser?
• Does the AI crawler get the same content as a human?
• Are screenshots consistent across devices?

Why it matters: If bots see different content than humans ("cloaking"), search engines may penalize your site. If AI crawlers can't read your content, you won't appear in AI-generated answers.

The tool checks for:

• Page title present and the right length (10–70 characters)
• Meta description present and the right length (50–170 characters)
• H1 heading present (and only one per page)
• Canonical URL set
• Structured data (schema markup) for rich results

Why it matters: These are the fundamentals. Missing any of them means missed opportunities in search results.

The tool flags:

• Thin content — fewer than 150 words on the page
• Light content — 150–500 words (may not compete well)
• Missing H2 subheadings for structure

Why it matters: Pages with thin content rarely rank well. Search engines and AI systems need enough text to understand what your page is about.

The tool checks:

• What percentage of images have alt text
• Flags pages where 30%+ of images are missing descriptions

Why it matters: Alt text helps search engines understand your images, improves accessibility, and can drive traffic from image search.

The tool tests whether AI crawlers (ChatGPT, Claude, Perplexity) can access your content:

• Can they reach the page at all?
• Do they see the same content as humans?
• Is there significant content loss for AI visitors?

Why it matters: More and more people find information through AI assistants. If your content isn't accessible to these bots, you're invisible in AI-generated answers.

The tool measures page weight (file size) across different visitors:

• Over 3 MB = Medium concern
• Over 1 MB = Worth watching

Why it matters: Heavier pages load slower, which hurts user experience and can lower your search rankings — especially on mobile.

The Dashboard shows every test you've run. You can:

• Search by URL, domain, test ID, or label
• Filter by run type (single URL, bulk, Screaming Frog)
• Limit by date range (All Time, 24h, 7 Days, 30 Days)
• Sort by date or total run size
• Switch views between cards and table
• Add/edit labels to organize runs (e.g., "Q1 Audit", "Client: Acme Corp")
• Delete runs you no longer need (you'll be asked to confirm)

At the top you'll see summary stats: total runs, average score, and your most recent run.

Use Cmd on Mac or Ctrl on Windows/Linux:

• Cmd/Ctrl + Enter — Run the active test/audit
• Cmd/Ctrl + 1 — Switch to User Agent Test
• Cmd/Ctrl + 2 — Switch to Screaming Frog Upload
• Cmd/Ctrl + A — Select all user agents
• Cmd/Ctrl + D — Clear selected user agents
• Cmd/Ctrl + / — Open/close help panel
• Escape — Clear the active form (or close help if it is open)

1. From the Dashboard or Run Details page, click Download Results (ZIP).
2. The ZIP file contains everything you need:
   • 00_START_HERE.md — Read this first, it explains the folder structure
   • 01_Gamma_Deck/ — A ready-made presentation deck (upload directly to Gamma or Graphy)
   • 02_Source_Data/ — CSV tables, CRO analysis, detailed findings
   • 03_Run_Artifacts/ — Screenshots, HTML snapshots, raw metadata

For client presentations: Upload the contents of 01_Gamma_Deck/ to Gamma for instant slide decks.

For deeper analysis: Open the CSVs in 02_Source_Data/tables/ in Excel or Google Sheets.

If your team uses Screaming Frog SEO Spider for full-site crawls, you can upload that data here for deeper analysis.

1. In Screaming Frog, export these CSVs:
   • Internal (All) — required
   • Page Titles — required
   • Meta Descriptions — required
   • H1 / H2 — required
   • Canonicals — required
   • Response Codes — required
   • Directives — required
   • Structured Data — optional but recommended
   • Inlinks — optional but recommended
2. Put all CSV files into a single ZIP file.
3. In the app, switch to the Screaming Frog Upload tab.
4. Upload your ZIP.
5. Optionally enter the site's main URL and check "JS was enabled" if applicable.
6. Click Run Audit.

The tool will analyze the entire crawl and generate findings, internal link opportunities, and a full export pack.

Each combination of URL + user agent runs a real browser session. Testing 50 URLs against 27 agents = 1,350 browser sessions.

Start small. Use 1–5 URLs with a Quick Preset (4–7 agents). Scale up once you're comfortable with the results.

The test won't start if no agents are selected. If nothing happens when you click Run Test, check that at least one checkbox is ticked — or just click a Quick Preset.

Most bot profiles run with JavaScript disabled on purpose. If a page relies heavily on JavaScript to load its content, many bots will see a blank or broken version. That's the point: the tool is showing you what non-rendering crawlers actually see.

A score of 40 doesn't mean your site is broken. It means the tool found issues worth investigating. Some findings might be intentional (e.g., a noindex on a staging page). Use the findings list to understand what's flagged and decide what actually needs fixing.

If you use the Screaming Frog upload feature, make sure your ZIP contains all 7 required CSV files. Missing files will cause the analysis to fail or produce incomplete results.

Page weight is measured, but this is not a performance testing tool like Lighthouse or PageSpeed Insights. The focus is on what different visitors see, not how fast they see it.