Advanced internal linking agent: Optimize your semantic cocoon in 5 phases
Internal linking is one of the most powerful and most underused SEO levers. This agent analyzes your site architecture, positions your page within its semantic cocoon, and generates a prioritized internal linking plan ready to implement.
At a glance
- What you'll do: Get a full diagnosis of your page's internal architecture (parent or child page), a selection of scored internal links ready to integrate, and a gap analysis of missing content.
- Time required: 5 to 10 minutes per page analyzed.
- Ideal for: Content managers and SEO specialists who want to strengthen their site's topical authority through structured, consistent internal linking.
What is it for?
Well-optimized content that isn't properly connected to the rest of the site loses a large part of its SEO potential. Internal linking is the nervous system of your semantic cocoon: it passes authority between pages, guides crawlers, and signals to Google the hierarchy of your content.
Yet most editorial teams approach internal linking intuitively — adding a few links as they write, without any methodology. The result: redundant links, missed opportunities, orphan pages, and an architecture that weakens the entire site.
This agent applies a 5-phase methodology: analyzing the existing architecture, positioning the page within its cocoon (parent, child, or grandchild), targeted search for candidate pages on your domain, relevance scoring, and identification of missing content to fill semantic gaps.
Good to know ℹ️: The agent automatically adapts the number of suggested links to the recommended content length — 5 links for short pages (under 1,000 words), 7 links for longer ones.
What you'll get
The agent delivers a structured report in two parts:
- A strategic report: identified cocoon level (parent/child) with justification, audit of existing links, and a gap analysis listing the 2 to 3 missing topics to create to strengthen topical authority.
- A concrete implementation plan: outbound links to create with suggested anchors and relevance scores (/5), plus a list of inbound link recommendations to add from other pages on the site.
How to do it
1) Prepare the prompt
First, replace [site.com] in the prompt with your site's root domain. This is the only change needed — all other variables are retrieved automatically by the agent.
Tip ✅: If you work across multiple sites, duplicate the agent and set up one version per domain to save time on each use.
2) Create the custom agent
In the Semji editor, navigate to the AI+ Agents feature and create a new agent with the following settings:
- Name: Advanced internal linking expert
- Instructions: Copy and paste the prompt below (after replacing
[site.com]). - Tools to enable:
- ✅ Retrieve SEO recommendations
- ✅ Google search
- ✅ Get web page content
[PROMPT]
Click Create to save your agent.
3) Run the analysis
Open the content to be linked in the Semji editor, make sure the Focus Keyword is set, then launch the agent. It automatically runs through all 5 phases of the methodology.
Click Run to start the analysis.
4) Read and apply the output
Strategic report: start by validating the identified cocoon level. If the agent classifies your page as a child when you thought it was a parent (or the reverse), this is an important signal — your site architecture may need to be reviewed.
Outbound links: prioritize links scored 5/5 (structural) then 4/5 (semantic). Links scored 3/5 are optional — add them only if the context allows for a natural integration.
Inbound links: pass the list of recommendations to your team or add them to your editorial calendar. These inbound links from other pages on the site are just as important as outbound links for consolidating the cocoon.
Gap analysis: topics identified as missing are content creation opportunities to prioritize. Add them directly to your editorial calendar.
Using the agent day to day
With every new piece of content: run the agent systematically before publishing to ensure every page is properly integrated into the cocoon from the moment it goes live.
During a site audit: work through strategic pages one by one to identify weak linking structures and orphan pages.
After a redesign or migration: the agent lets you quickly verify that the internal architecture has been preserved and that new content is properly positioned within its cocoon.
Pro tip 💡: Use the gap analysis as a direct input for your editorial calendar. The missing content identified by the agent is what has the greatest impact on the site's overall topical authority.
Going further
Once internal linking is optimized, strengthen the semantic consistency of your pages with complementary agents:
- Use the SERP behavioral analysis agent to make sure every page in the cocoon matches the format Google expects.
- Review Semji's internal linking recommendations to cross-reference the agent's suggestions with the opportunities automatically detected by the platform.
- Enable SEO recommendations to enrich parent pages with missing semantic terms.
Important ⚠️: The
site:command used by the agent relies on Google's index — some recent or poorly indexed pages may not appear in results. If needed, supplement with a manual search in your CMS.
Useful links: