Bulk Hreflang Tag Checker

WHAT IT DOES

Bulk Hreflang Tag Checker is a developer and SEO tool that streamlines the process of checking hreflang tags across multiple URLs. Instead of manually visiting each page, inspecting the source code for hreflang link tags, and recording language-country pairs—a process that can be tedious and time-consuming—this script automates the entire workflow. It scans the current page for URLs and links, displays them as a scrollable checklist with titles and hostnames, and performs GET requests to fetch hreflang tags (link[rel="alternate"][hreflang]) for each selected URL. The script displays all hreflang language-country pairs found on each page, counts the number of tags, and indicates the status (✅ Found, ❌ None, ⏱ Timeout, ❌ Error). Results can be exported as plain text, CSV, or TSV via clipboard. This is ideal for international SEO specialists, web developers, content managers, and anyone who needs to audit hreflang implementations across multilingual websites.

WHERE IT RUNS

This script is universal—it runs on any website (*://*/*) as a userscript injected through the BotGentz extension. It operates within the context of your current browser tab and cannot access other tabs, bookmarks, history, or downloads. The script reads the page DOM to identify URLs using links and text patterns, extracts titles and hostnames, and performs GET requests to fetch HTML content and parse hreflang link tags. All operations occur locally in your browser; no data is sent to external servers except for the page requests themselves.

HOW TO USE

1. Navigate to any page containing a list of URLs you want to check—a site directory, a client portfolio, a links page, or any text with URLs.

2. Click the BotGentz extension icon and select "Bulk Hreflang Tag Checker" from the script list.

3. The panel opens on the right side of the page. It automatically scans the current page for URLs.

4. Review the detected URLs, showing titles and hostnames with pending status (⏳).

5. Configure "Timeout (ms)" (default 10000) and "Max concurrent" (default 3) to control the checking process.

6. Select your export format: Plain Text, CSV, or TSV.

7. Check the boxes next to URLs you wish to check. Use "Select All" or "Deselect All" for quick selection.

8. Click "Check Hreflang" to begin. The script fetches each page and extracts all hreflang tags.

9. Results appear in the panel with status indicators showing the number of hreflang tags found.

10. Click "Export Results" to copy the hreflang check results to your clipboard in the selected format.

WHY IT WORKS WHERE OTHERS FAIL

Many SEO audit tools require crawling entire websites or paying for API access. This script takes a different approach: it works with URL lists you already have and performs on-demand checks using simple GET requests and HTML parsing. It extracts hreflang tags using regex patterns that handle variations in attribute quoting and ordering, supporting both rel="alternate" hreflang="xx" and hreflang="xx" rel="alternate" variations. The script uses a flexible URL detection that finds links in both anchor tags and plain text, making it compatible with a wide range of page formats. By supporting configurable concurrency and timeout settings, it efficiently handles large URL lists without overloading your browser or the target servers. The detailed status indicators provide immediate visual feedback, and the export functionality makes it easy to share audit results with your team or integrate into other workflows.

THE PANEL

The script uses BotGentz's BGPanel system, which provides a floating, draggable panel on the right side of your screen. Drag the panel by its header to reposition it anywhere on the page—the panel remembers its position per site and snaps to the nearest edge when released. Click the minimize button to collapse the panel to a small floating bubble; click the bubble to expand it back. Resize the panel vertically by dragging its bottom edge. Press the Escape key to close the panel entirely. All panel state (position, collapsed/expanded) is persisted locally using GM_setValue, so your preferences survive page reloads.

PLEASE NOTE

This userscript requires the free BotGentz browser extension—it is not a standalone application. The script fetches the HTML content of each selected URL to extract hreflang tags; this may be slow for large numbers of URLs and depends on the target server's response time. Some websites may block automated requests or return non-HTML content. The script does not store, transmit, or process any of your data outside your local browser except for the page requests. It does not access your password, hidden inputs, or file inputs. Use responsibly and respect website robots.txt and terms of service.