Internal Link Opportunity Mapper

Store Positioning

Store title: Internal Link Opportunity Mapper

Short description: Suggest internal link opportunities based on crawl text, pages, topics, anchors, and site graph context.

SEO title: Internal Link Opportunity Mapper — evidence-backed report and intelligence workflow

SEO description: Suggest internal link opportunities based on crawl text, pages, topics, anchors, and site graph context. Use it to turn sources into decision-ready rollups, executive summaries, and evidence-backed recommendations.

Categories: SEO_TOOLS

Keywords: internal, link, opportunity, mapper, premium report/intelligence actor

Fixed-Inclusive PPE Pricing

This actor uses pay-per-event pricing. Event prices include Apify platform usage; users are not expected to pay a separate platform-usage pass-through charge for the configured pricing model.

• Tier: R1 — Premium report/intelligence actor
• Primary event: source-processed at $0.00892 base
• Default max charge: $25.00
• Store discounts: FREE/BRONZE base, SILVER discounted, GOLD deepest approved discount

Event set:

• actor-start: base $0.02000, GOLD $0.01600. Internal Link Opportunity Mapper: charged when actor start is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• source-processed: base $0.00892, GOLD $0.00714. Internal Link Opportunity Mapper: charged when source processed is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• finding-emitted: base $0.00892, GOLD $0.00714. Internal Link Opportunity Mapper: charged when finding emitted is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• report-section-generated: base $0.03600, GOLD $0.02880. Internal Link Opportunity Mapper: charged when report section generated is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• executive-report-generated: base $0.25000, GOLD $0.20000. Internal Link Opportunity Mapper: charged when executive report generated is completed. The price includes Apify platform usage; no separate usage pass-through is intended.

Public Task Concepts

• Build an Internal Link Opportunity stakeholder brief from source rows
• Prioritize Internal Link Opportunity findings with evidence and confidence
• Summarize Internal Link Opportunity metrics into recommended actions
• Prepare an Internal Link Opportunity source table with uncertainty notes
• Export Internal Link Opportunity decision rows for review

Suggest evidence-backed internal links from supplied page and site-graph context.

What This Actor Does

Internal Link Opportunity Mapper evaluates a proposed source page, target page, and anchor against supplied page text or topic labels. It measures topical overlap, verifies that the anchor is grounded in the source context, checks same-site identity, and detects self-links or links that already exist.

Each result includes a linkOpportunityRows evidence object with normalized source and target topics, overlap, existing links, same-origin status, anchor support, outbound-link count, and target inbound-link count. Optional JSON and Markdown reports summarize the resulting findings.

What This Actor Does Not Do

• It does not crawl an entire site or choose target pages without supplied graph context.
• Fetching a source URL can supply source text, but target text, target topics, and graph evidence must still be provided.
• It does not render JavaScript or bypass access controls.
• It does not guarantee that a suggested link improves rankings; the output is editorial and technical evidence for review.

Best Use Cases

• validate links proposed during content refreshes
• find duplicate, self, external, or weakly related targets
• verify anchor text against nearby source wording
• prioritize underlinked target pages with supplied graph counts
• export internal-link QA evidence for editors or clients

Input Fields

Field	Type	Default	Notes
records	array	two built-in records	Proposed opportunities. Put graph and text evidence in each record's metadata.
urls	array	[]	Explicit source URLs; these override schema-populated default records.
fetchUrls	boolean	false	Fetch source text for URL records.
fetchTimeoutMs	integer	12000	Per-request timeout, capped at 30 seconds.
watchTerms	array	anchor/link terms	Terms retained in the general result summary.
includeReport	boolean	true	Writes JSON and Markdown report artifacts.
maxItems	integer	2	Result cap; maximum 50.
maxTextBytes	integer	500000	Text cap per record.

Important metadata fields are sourcePage, targetPage, anchorSuggestion, sourceText or sourceTopics, targetText or targetTopics, existingLinks, outboundLinkCount, and targetInboundLinkCount.

Example Input

{
  "records": [
    {
      "sourceId": "roof-guide-link",
      "sourceUrl": "https://example.com/guides/roof-maintenance",
      "title": "Roof maintenance guide",
      "metadata": {
        "sourcePage": "https://example.com/guides/roof-maintenance",
        "targetPage": "https://example.com/services/roof-repair",
        "anchorSuggestion": "roof repair service",
        "sourceText": "Inspect roof damage and choose a roof repair service before leaks spread.",
        "targetText": "Roof repair service for storm damage and active leaks.",
        "existingLinks": ["https://example.com/contact"],
        "targetInboundLinkCount": 1
      }
    }
  ],
  "maxItems": 1,
  "includeReport": true
}

Output Evidence

The top-level row contains source identity, status, severity, score, findings, recommendations, timestamps, and the primary PPE event. metadata.sourceSpecific.linkOpportunityRows[0] contains the normalized link decision evidence. A valid opportunity emits link-opportunity; invalid cases can emit already-linked, self-link, external-target, low-topic-overlap, generic-anchor, or anchor-not-grounded.

Cost Control

• Start with one or two supplied opportunities.
• Keep URL fetching off when page text is already available.
• Supply explicit topic labels for deterministic large-text comparisons.
• Disable report artifacts when only dataset rows are needed.

Public Task Examples

• build a stakeholder brief from link-opportunity evidence
• prioritize contextual links with topic and graph support
• summarize same-site and duplicate-link findings
• prepare a source-target evidence table
• export decision rows for editorial review

Limitations

Topic extraction is lexical and does not replace semantic search, embeddings, or editorial judgment. Relative URLs are compared against the supplied source page. JavaScript-rendered links, crawl discovery, and sitewide PageRank calculations require separate crawl data.

Source And Safety Notes

Use public or permissioned pages. Do not include credentials, private user data, or restricted content. Treat recommendations as QA evidence and review each insertion in its paragraph context.

Changelog

• 2026-07-10: Added topic-overlap, anchor-grounding, same-origin, duplicate-link, and graph evidence with expanded regression coverage.