1. Scan
Run the read-only scanner against the Markdown export or content directory. It reports the file, line, destination, suspicion score, and reasons for the flag.
Resources · Internal linking
Use the anchor scanner and replacement assistant to find over-optimized link text, then revise it so readers and search engines can understand the destination before they click.
A safe editorial process
The tools are intentionally conservative. Detection is automatic, but the final wording decision belongs to a human editor who understands the article and the destination page.
Run the read-only scanner against the Markdown export or content directory. It reports the file, line, destination, suspicion score, and reasons for the flag.
Check whether the destination is informational, commercial-investigation, or transactional. The anchor should accurately predict what the visitor will find after clicking.
Use the companion rewriter only after review. It creates timestamped backups before changing a file, so the edit can be reversed.
Read-only scan
The scanner checks Markdown, reference-style Markdown, and inline HTML links. It does not edit content.
python3 tools/scan_keyword_stuffed_anchors.py content
# Save a review report
python3 tools/scan_keyword_stuffed_anchors.py content \
--json /tmp/anchor-scan.jsonSuggestion assistant
Suggestion mode is the default. When you deliberately apply changes, the script creates timestamped backups unless you explicitly disable them.
python3 tools/rewrite_keyword_stuffed_anchors.py content
# Apply only after review
python3 tools/rewrite_keyword_stuffed_anchors.py content \
--apply --yesUse --report /tmp/anchor-rewrites.json to save suggestions for review.
Destination-aware wording
A neighborhood guide should sound like a guide. A listings page should invite a search. Avoid using one commercial phrase as the anchor for every destination.
| Destination | Prefer | Avoid as the default |
|---|---|---|
| Neighborhood article | Explore the White Eagle neighborhood guide | White Eagle homes for sale Naperville IL |
| Neighborhood hub | Browse Naperville neighborhood guides | Best Naperville subdivision listings |
| Search page | Search current Naperville homes | Naperville real estate |
| Valuation page | Request a home valuation | Best Naperville real estate agent |
| Buyer planning | Use the buyer planning checklist | Buy a home in Naperville |
| Seller guidance | Browse seller guidance | Sell your Naperville home fast |
Editorial checklist