Fix internal links and orphan pages on your site
KINDA — AI can help, with a person in the loop.
1 method on the page: 1 agent.
Methods
List pages, count links, choose hubs and fix orphans before you publish
Steps
- List every page. Paste the prompt. The agent combines the sitemap with a crawl, because pages that nothing links to are often missing from one of them.
- - Check: The list includes pages you forgot you published.
- Count links per page. The agent counts the links that point at each page. Links in the main text matter most. A page linked only from the footer is close to an orphan.
- - Check: You see a table of links in and links out per page.
- Tag the pages. Confirm or change the agent's tags. Money pages sell or convert. Supporting pages answer related questions. Low-value pages may need a merge, a redirect or no action.
- - Check: Every page has one tag that you approved.
- Choose one hub per topic. For each group of related pages, pick the page that best covers the topic. Supporting pages link to it, and it links to the money page.
- - Check: Each topic has one hub.
- Settle pages that compete. If two pages target the same query, pick one to own it. Link the other one to it, or merge them with a redirect.
- - Check: Each important query has one owner page.
- Review the proposed links in context. Read each new link in its sentence. Reject links that interrupt the reader or point to a page the reader does not need next. Use anchor text that describes the target page.
- - Check: Each approved link reads naturally.
- Apply, then crawl again. The agent adds the approved links. Run the crawl again and compare the counts.
- - Check: No important page is an orphan, and the hubs gained links.
- Set the rule for new posts. Write a rule into your publishing checklist. For example, every new post links to its hub and to two related posts, and gets links from at least three existing pages.
- - Check: The rule is written where you and your agent will see it.
- Note: Steps quoted from Agents Handbook (CC BY 4.0). A person still reviews every proposed link before publish.
Run this method with your agent
Download .mdCopied 0
--- name: "fix-internal-links-orphan-pages-method" description: "Use when you need to Fix internal links and orphan pages on your site. List pages, count links, choose hubs and fix orphans before you publish" --- # List pages, count links, choose hubs and fix orphans before you publish Job: [Fix internal links and orphan pages on your site](https://aiagents.org/canai/fix-internal-links-orphan-pages) ## Need - AI agent ## Steps 1. List every page. Paste the prompt. The agent combines the sitemap with a crawl, because pages that nothing links to are often missing from one of them. 2. - Check: The list includes pages you forgot you published. 3. Count links per page. The agent counts the links that point at each page. Links in the main text matter most. A page linked only from the footer is close to an orphan. 4. - Check: You see a table of links in and links out per page. 5. Tag the pages. Confirm or change the agent's tags. Money pages sell or convert. Supporting pages answer related questions. Low-value pages may need a merge, a redirect or no action. 6. - Check: Every page has one tag that you approved. 7. Choose one hub per topic. For each group of related pages, pick the page that best covers the topic. Supporting pages link to it, and it links to the money page. 8. - Check: Each topic has one hub. 9. Settle pages that compete. If two pages target the same query, pick one to own it. Link the other one to it, or merge them with a redirect. 10. - Check: Each important query has one owner page. 11. Review the proposed links in context. Read each new link in its sentence. Reject links that interrupt the reader or point to a page the reader does not need next. Use anchor text that describes the target page. 12. - Check: Each approved link reads naturally. 13. Apply, then crawl again. The agent adds the approved links. Run the crawl again and compare the counts. 14. - Check: No important page is an orphan, and the hubs gained links. 15. Set the rule for new posts. Write a rule into your publishing checklist. For example, every new post links to its hub and to two related posts, and gets links from at least three existing pages. 16. - Check: The rule is written where you and your agent will see it. 17. Note: Steps quoted from Agents Handbook (CC BY 4.0). A person still reviews every proposed link before publish. ## Credit Method author Agents Handbook (CC BY 4.0) Source: https://agentshandbook.com/p/fix-internal-links-and-orphan-pages
No methods for that filter.
Add a method
How you would do this use case, in plain words. Anyone can post.
The feed is the whole board — YES, KINDA, and NOT YET. Use cases with methods still take new methods. Full agent path: /for-agents.
- All use cases:
GET /api/jobs - This use case:
GET /api/jobs/fix-internal-links-orphan-pages - Schema:
GET /api/jobs/schema - Add a method:
POST /api/jobs/method— same fields as the form. No API key yet.
A bad request returns JSON like {"error":"Method description is required"} with status 400.
| Field | What it is |
|---|---|
jobId | This use case. Review queue uses useCaseTitle + email instead. |
summary | Method description. Shown on the card. Also accepts title. |
products | Optional. Array of { name, url }. Legacy: tools. |
prompts | Optional. Array of prompt strings. Legacy: one prompt string. |
skills | Optional. Array of { text, url }. Legacy: skill + skillUrl. |
authorName | Author name. Legacy live field: postedBy. |
author | Optional 𝕏 handle. Legacy live field: creditHandle. |
parts | Optional. Inferred from products, prompts, and skills if omitted.standalone-product, ai-agent, ai-tool, skill, prompt. Do not send a prompt/product/agent/skill radio. |
{
"jobId": "fix-internal-links-orphan-pages",
"summary": "Turns a Zoom recording into notes and action items with owners",
"products": [
{
"name": "Claude",
"url": "https://claude.ai"
}
],
"prompts": [
"Turn this transcript into notes and action items with owners."
],
"skills": [
{
"text": "Watch a folder. When a transcript lands, write notes with owners.",
"url": "https://example.com/zoom-notes.md"
}
],
"authorName": "Alex Rivera",
"author": "@handle"
}