Check Prod Site Links
Check all links and anchors on the PROD website (https://itautonomos.com) using lychee link checker.
Prerequisites
lychee must be installed:
bash
brew install lychee
URLs to check
Main pages (index)
- •https://itautonomos.com/ (English)
- •https://itautonomos.com/ru/ (Russian)
- •https://itautonomos.com/ua/ (Ukrainian)
- •https://itautonomos.com/es/ (Spanish)
Instructions
- •
Check if lychee is installed:
bashwhich lychee || echo "lychee not found - install with: brew install lychee"
- •
Run lychee for each page with anchor fragment checking enabled:
bashlychee --include-fragments --exclude "ec.europa.eu/taxation_customs/vies" --exclude "bit.ly" "URL" 2>&1
The
--excludeflags skip:- •EU VIES VAT validation page (uses JavaScript routing - false positive)
- •bit.ly links (tested separately in
/tests-prod-test-bitly-linksto avoid inflating Bitly analytics)
- •
Run all 4 checks in parallel using the Task tool for efficiency, or run sequentially:
bash# Example for one page: lychee --include-fragments --exclude "ec.europa.eu/taxation_customs/vies" --exclude "bit.ly" "https://itautonomos.com/ru/" 2>&1
- •
Parse the output for each page:
- •Total links checked
- •OK links (✅)
- •Errors (❌) - broken links or missing anchors
- •Excluded (👻) - mailto links, etc.
- •Redirects (🔀)
Known Exclusions
Some links may show errors but are false positives:
- •JavaScript-based anchors (e.g.,
https://ec.europa.eu/taxation_customs/vies/#/vat-validation) - these use client-side routing and cannot be validated by lychee - •Rate-limited sites - some external sites may temporarily block requests
Output Format
Summary Table
code
## PROD Site Link Check Results | Page | Total | OK | Errors | Excluded | Status | |------|-------|-----|--------|----------|--------| | EN Index (/) | 150 | 148 | 0 | 2 | ✅ | | RU Index (/ru/) | 171 | 168 | 0 | 3 | ✅ | | UA Index (/ua/) | 165 | 162 | 0 | 3 | ✅ | | ES Index (/es/) | 150 | 148 | 0 | 2 | ✅ |
Errors Report (if any)
code
## ❌ Errors Found ### RU Index (/ru/) 1. [ERROR] https://example.com/page#section | Cannot find fragment 2. [ERROR] https://broken-link.com | Network error ### Action Required - Fix broken links listed above - For anchor errors: verify the target section exists on the page
Final Status
End with a clear summary:
code
## Final Status ✅ **ALL PROD LINKS VALID** - All 4 pages passed (X total links, Y anchors verified)
OR
code
## Final Status ❌ **PROD ISSUES FOUND** - X broken link(s) across Y page(s) Action required: Fix the errors listed above and re-deploy.
Important Notes
- •
--include-fragmentsenables anchor/fragment checking (critical for internal navigation) - •lychee downloads full HTML to verify anchors exist on remote pages
- •Exit code 0 = all OK, exit code 2 = errors found
- •Some JavaScript-rendered anchors cannot be validated (known limitation)
- •External sites may rate-limit or block requests - retry if needed
- •This checks the LIVE PROD site - ensure changes are deployed first