RankRecon User Guide
Complete Guide
Everything you need to know about using RankRecon for SERP extraction and analysis. From installation to advanced settings.
Getting Started
Installation
Basic Workflow
Search Google
Navigate to any supported Google domain and run your search as normal. RankRecon works on 25+ Google country domains - see Supported Domains.
Extract and analyse
Click the RankRecon icon to extract the organic results, then "Analyse All" to fetch metadata from each page. RankRecon opens each page in a background tab, reads the data, then closes the tab.
Export Data
Export the raw dataset in your preferred format - CSV, Excel, JSON, Markdown, HTML, or Plain Text. Everything is generated locally with no cloud processing. See Export Formats for details.
View Page 1 Analysis
Generate the SERP Analysis report for patterns and recommendations layered on top of the raw data: archetype detection, content targets, trust signals, differentiation opportunities, and a build checklist. Available as Markdown or HTML - see SERP Analysis Report.
Data Extracted
RankRecon produces 25 data points for each ranking page across three groups: four extracted straight from Google's results page (SERP fields), nineteen collected by visiting each URL (Page fields), and two derived by RankRecon's own pattern matching (Inferred fields). Toggle individual fields on or off in Settings → Export Fields.
SERP Fields
Pulled from Google's results page during extraction. No URL visits needed.
| Field | Description |
|---|---|
| Position | Ranking position |
| URL | Page URL |
| SERP Title | Title shown in Google |
| SERP Description | Snippet shown in Google |
Page Fields
Collected by visiting each URL during analysis. Click "Analyse All" after extraction to fetch these.
| Field | Description |
|---|---|
| Page Title | HTML <title> tag |
| Meta Description | SEO meta description |
| H1 Heading | First <h1> on page |
| Word Count | Visible text word count |
| H1 Count | Number of H1 headings |
| H2 Count | Number of H2 headings |
| H3 Count | Number of H3 headings |
| H4 Count | Number of H4 headings |
| Image Count | Number of images |
| Internal Links | Same-domain links |
| External Links | Different-domain links |
| Video Embeds | YouTube/Vimeo videos |
| Table Count | Number of tables |
| Paragraph Count | Number of paragraphs |
| List Items | Number of list items (<li> elements) |
| Forms | Number of form elements |
| Buttons | Number of button elements |
| Has TOC | Table of contents detected |
| Schema Types | Detected structured data types |
Inferred Fields
RankRecon's own interpretation of the SERP - pattern matching across the collected data rather than raw values lifted from a page. See SERP Analysis Report for how these are derived.
| Field | Description |
|---|---|
| Archetype | Content pattern cluster (e.g. listicle, comprehensive guide, tool, product page, homepage) |
| Intent | Page search intent classification (e.g. Commercial, Informational, Local) |
Handling Extraction Failures
If you use RankRecon for any length of time, you're going to come across sites that don't load, sites with bot protection (Cloudflare, hCaptcha and friends), pages that take too long to render, and other assorted weirdness. When processing has finished, these show up listed as "Error" in the results table - the URL and position are still there, but the rest of the row reads "Failed to extract".
Two ways to handle them.
Method 1: Retry all failed rows
When one or more errors are present, a Retry button appears on the results screen. Click it and RankRecon will work through the failed rows again, opening each in a background tab as before. This often resolves transient issues: a momentary network hiccup, a server that was slow to respond first time round, a tab that didn't quite settle before being read. If it works, great, you're done.
Method 2: Open and Redo (manual recovery)
If retrying doesn't fix it, you need to step in yourself. Every row in the results table has an "Open" link and a "Redo" link, which between them let you resolve the page manually and then feed the now-working page back to RankRecon.
- Click the "Open" link next to the failed row. The page loads in a new tab.
- If there's a captcha or bot challenge, complete it. If the page is just slow, wait for it to settle. Whatever was blocking RankRecon, clear it in the open tab as you would for any normal browsing.
- Once the page has resolved and is showing the real content, switch back to the SERP tab and open RankRecon again. Click the "Redo" link next to that row.
- RankRecon reads the data directly from the open tab. Because you've already cleared whatever the obstacle was, this succeeds.
- Close the tab and carry on.
The same Open/Redo loop also helps when a row looks like it scraped successfully but the numbers don't match the page (e.g. a JavaScript-heavy site that hadn't finished rendering when RankRecon first read it). Open, let it render, Redo.
SERP Analysis Report
Once RankRecon has analysed the SERP, the Analysis report looks across all the results and tries to find patterns. It tells you which content shapes Google is rewarding for this query, what the top pages have in common, where the gaps are, and gives you a build checklist.
When to Use It
Generate a SERP Analysis report when you want to:
- Plan new content that competes with existing rankings
- Audit existing content against top performers
- Brief writers with specific, data-backed targets
- Identify quick wins for content updates
Report Sections
SERP Archetypes
Groups ranking pages by content pattern - listicles, comprehensive guides, tools, product pages, or homepages. This shows you what format Google is rewarding for this query.
Shape of the SERP
Maps the full layout of page 1 - organic results interleaved with ads, AI Overviews, People Also Ask, Local Packs, videos, shopping carousels, or top stories. This shows you what's competing with the organic results for attention on this query.
Content Targets by Archetype
Recommended benchmarks based on top performers:
- Target word count (median and range)
- Heading structure (H2, H3, H4 counts)
- Image usage
- List and table adoption
Trust & Conversion Signals by Archetype
Compares adoption of credibility factors across ranking pages:
- Schema markup types
- Contact forms
- Video content
- Table of contents
- External citations
Differentiation Opportunities
Identifies features with low adoption among competitors - elements you could add to stand out. If only 20% of ranking pages have video, adding video could be a differentiator.
Build Checklist
Auto-generated action items based on the analysis. Use this as a starting point for content briefs or as a self-review checklist before publishing.
Export Options
SERP Analysis reports can be exported as:
Markdown
For documentation, Notion, or developer workflows.
HTML
Styled report you can open in a browser or share.
Multi-Page Analysis
RankRecon can extract results from more than just the first page of a SERP, useful when you want to see what's ranking beyond the top 10.
How It Works
- Before clicking Extract, use the "Pages to extract" stepper in the popup to choose how many pages to pull in (1 to 10).
- RankRecon extracts page 1 from the SERP you're already on.
- For pages 2 onwards, RankRecon opens each subsequent SERP page in a background tab, extracts the results, and closes the tab. Your active tab stays put.
- All the results are combined into one dataset, ready to analyse, export, or run the SERP Analysis report against.
Multi-page extraction sends automated requests to Google, which may conflict with their Terms of Service. RankRecon paces the requests, but it's still automated browsing. Use at your own discretion.
When to Use Multi-Page Analysis
- Analysing competitive SERPs where you need data beyond the top 10
- Building content benchmarks from a larger sample
- Researching content patterns where page 1 alone isn't enough
Export Formats
Raw Data Exports
| Format | Best For |
|---|---|
| Excel (.xlsx) | Spreadsheet analysis, client deliverables |
| CSV (.csv) | Import into any tool, large datasets |
| JSON (.json) | Developer workflows, data pipelines |
| Markdown (.md) | Documentation, Notion, GitHub |
| HTML (.html) | Styled tables viewable in any browser |
| Plain Text (.txt) | Quick review, email sharing |
SERP Analysis Report Exports
SERP Analysis reports are available in Markdown and HTML formats. These exports include the full analysis with content targets, trust signals, and the build checklist.
All exports are generated locally in your browser.
Settings Reference
Access settings by clicking "Settings" in the popup footer, or right-click the extension icon and select "Options".
Appearance
Theme
Choose between Light, Dark, or System (follows your OS/browser preference).
Firefox note: "System" follows the Firefox browser theme.
Export Settings
Default Export Format
Choose which format is pre-selected when you click Export. Options: CSV, Excel, JSON, Markdown, Plain Text.
Remember last format used
When enabled, RankRecon remembers your last export format and uses it as the default next time.
Export Fields
Select which data fields to include in exports. Toggle individual fields on or off to customise your output. Position and URL are always included. This affects all export formats except SERP Analysis reports.
Scraping Settings
Page Render Delay
Time to wait (1-10 seconds) for page content to render after loading. Default: 3 seconds.
Increase this delay for sites that use client-side rendering (React, Vue, Angular, etc.).
Keep tabs open after scraping
When enabled, the tabs RankRecon opens remain open after scraping completes. Useful for manual review or debugging, but be careful if you're processing multiple SERP pages - you're going to have a lot of open tabs!
Advanced Settings
Expand the "Advanced Settings" section to access these options.
Enable debug logging
Outputs diagnostic information to the browser console (F12 → Console).
Report errors to help improve RankRecon
When enabled, sends anonymous error reports when something goes wrong.
Only the error type and domain name are collected. No page paths, search queries, or personal data. See our Privacy Policy for details.
Custom SERP Selector
Override the default result detection with a custom CSS selector. Only use this if standard extraction fails on a particular Google layout.
Selector should match <a> elements containing result links. Example: div.custom-result a
Using an invalid selector will cause extraction to fail. Clear the custom selector to restore normal behaviour.
Reset All Settings to Defaults
Restores all settings to their original values. Requires confirmation.
Supported Google Domains
RankRecon works on 25+ Google country domains:
Troubleshooting
"Not a Google search results page"
RankRecon only works on Google search results pages. Make sure you're on:
- A supported Google domain (see list above)
- A search results page (URL contains
/search) - Not on Google Images, News, Maps, or other specialised search types
No results detected
If RankRecon shows "0 results found":
- Make sure you're on a standard web search results page
- Scroll down to ensure results have loaded
- Try refreshing the page
- Check if you have browser extensions that modify Google's layout
If the problem persists, try the Custom SERP Selector in Advanced Settings, or open an issue on GitHub.
Extraction fails for some pages
Individual pages may fail to extract due to:
- Authentication required - The page requires login
- Bot protection - The site blocks automated requests (e.g. a Cloudflare challenge)
- Slow loading - Try increasing the Page Render Delay setting
- JavaScript errors - The page has errors preventing proper rendering
Failed pages don't stop the run; RankRecon continues with the remaining results. You have two ways to recover:
- Retry Failed Pages - When the run finishes, a "Retry Failed Pages" button appears above the export controls if any pages failed. Click it to re-run just the failed entries in one go. Best for transient issues like network blips or slow loads.
- Open + Redo - For pages that need manual intervention (filling in a CAPTCHA, dismissing a cookie banner, logging in):
- Click the "Open" link next to the failed result. It opens in a new tab.
- Resolve whatever's blocking the page (complete the CAPTCHA, accept cookies, sign in, etc.).
- Leave the tab open and return to RankRecon.
- Click the "Redo" link next to the same result. RankRecon will read from the open tab and add the data to your result set.
Multi-page extraction stopped early
When extracting more than one SERP page, the walk can stop before reaching the page count you set. RankRecon always keeps the results gathered so far. Common reasons:
- Google CAPTCHA challenge - Google sometimes challenges automated browsing. A shield warning appears in the popup with the page number where it happened. Complete a Google search manually in your browser to clear the challenge, then try again.
- Network or page-load error - A SERP page failed to load. A warning banner shows which page failed and what was collected before the stop.
- No more results - Google returned an empty page, meaning the walk reached the end of the available results.
In all three cases, the results already collected are available to export or analyse as normal.
Export not downloading
If clicking Export doesn't download a file:
- On the first export, your browser asks for permission to download. Approve the prompt to allow saves. If you miss it, look for a permission indicator near the address bar.
- On Firefox, the save dialog or download notification can be hidden behind the RankRecon popup. Close the popup to check.
- Check your browser's download settings
- Look for a blocked download notification
- Try a different export format
- Ensure you have results to export
Extension icon not visible
Click the extensions (puzzle) icon in your browser toolbar and pin RankRecon to keep it visible.
Browser Permissions
RankRecon requests only the permissions necessary to function:
| Permission | Why it's needed |
|---|---|
content_scripts | Read SERP results on 25 supported Google domains (google.com, google.co.uk, etc.). Granted at install time. |
activeTab | Communicate with the active tab when you click the extension icon, so the SERP can be read. |
storage | Save your settings locally |
host_permissions (optional) | Open and read competitor pages during analysis. RankRecon asks for this on your first scrape rather than at install, so the broader access is granted only when you're about to use it. |
downloads (optional) | Save export files to your computer. Approved by your browser the first time you export. |
RankRecon does NOT:
- Access your browsing history
- Read data from non-Google pages(except during analysis)
- Send your personal data, search queries, or browsing data to external servers
- Require an account or API key
Getting Help
For bug reports, feature requests, or questions about RankRecon, visit our GitHub Issues page:
Reporting Bugs
When creating a new issue, please include:
- Browser name and version
- RankRecon version (shown in the extension popup)
- Step-by-step instructions to reproduce the issue
- What you expected to happen vs. what actually happened
- The Google search URL you were using (if applicable)
Response Times
RankRecon is built by a small team. We monitor GitHub Issues and aim to respond promptly.
About Mission Systems
RankRecon is built by Mission Systems, an independent software company based in the UK. We build developer tools and utilities with a focus on privacy, simplicity, and getting out of your way.