Affiliate Link Injector

Scan content for product mentions and auto-insert affiliate links with FTC compliance disclosures. Use when the user needs to monetize blog posts, product reviews, or guides with tracked affiliate links while maintaining legal compliance.

ncreighton@ncreighton

Install

openclaw skills install @ncreighton/affiliate-link-injector

Overview

The Affiliate Link Injector automates the process of scanning content for product mentions and strategically inserting tracked affiliate links with FTC-compliant disclosure notices. This skill is designed for content creators, bloggers, ecommerce marketers, and agencies who need to monetize content while maintaining legal and ethical standards.

Why This Matters

Revenue Automation: Convert existing content into income streams without manual link hunting
FTC Compliance: Automatically adds required disclosures (FTC Act Section 5) to protect your brand and audience
Link Tracking: Integrates with Amazon Associates, ShareASale, Impact, CJ Affiliate, and custom affiliate networks
Content Preservation: Maintains readability and SEO value while injecting contextual affiliate links
Multi-Platform Support: Works with WordPress, Medium, Substack, Ghost, static HTML, and Markdown files

Integrations

This skill connects with:

Amazon Associates (product links, commission tracking)
ShareASale (1000+ merchant networks)
Impact (enterprise affiliate management)
CJ Affiliate (B2B and B2C programs)
WordPress (direct post/page injection via REST API)
Google Docs (scan and suggest links for approval)
Slack (send compliance reports and link suggestions)

Quick Start

Example 1: Scan Blog Post and Inject Amazon Links

text

Scan this blog post for product mentions and inject Amazon Associates 
affiliate links with FTC disclosures. Use my affiliate ID: 
yourname-20. Only link products that are actually available on Amazon.

[Paste your blog post content here]

Expected Output: Blog post with [Product Name](https://amazon.com/...?tag=yourname-20) links and a disclaimer like: "This post contains affiliate links. We earn a commission if you click and purchase at no additional cost to you."

Example 2: Monetize Product Review with Multiple Networks

text

I have a product review comparing 5 laptop brands. Add affiliate links 
from Amazon Associates, B&H Photo, and Newegg. Insert FTC disclosure 
at the top. Format: Markdown. Only inject links where I naturally 
mention the product.

Review content:
[Paste your review]

Expected Output: Review with contextual affiliate links to each retailer, FTC disclosure banner, and a summary table showing which affiliate networks were used.

Example 3: Bulk Scan WordPress Posts for Monetization Opportunities

text

Scan my WordPress blog for all product mentions across 10 recent posts. 
Generate a report showing:
1. Which products can be monetized (with affiliate network options)
2. Where to insert FTC disclosures
3. Recommended link anchor text for SEO
4. Compliance risk assessment

WordPress URL: https://myblog.com
API key: [your WordPress REST API key]

Expected Output: CSV report with post titles, product mentions, recommended affiliate networks, compliance notes, and a one-click approval button to auto-inject links.

Example 4: Create FTC-Compliant Disclosure Variants

text

Generate 5 different FTC disclosure statements for my blog that are:
1. Concise (one sentence)
2. Friendly and conversational
3. Legal-safe (covers all affiliate relationships)
4. Mobile-friendly (short version for sidebars)
5. Transparent (mentions specific networks: Amazon, ShareASale)

My blog tone: [casual/professional/humorous]

Expected Output: 5 disclosure variants with guidance on placement and legal compliance notes.

Capabilities

1. Intelligent Product Detection

Scans content for product names, brands, and model numbers
Uses NLP to distinguish between casual mentions and recommendation contexts
Identifies products already linked (avoids duplicate linking)
Recognizes variations: "MacBook Pro" = "MacBook Pro 16-inch M2"

2. Affiliate Network Matching

Automatically matches products to available affiliate programs
Prioritizes highest-commission networks
Falls back to general retailers (Amazon) for unmatched products
Supports custom affiliate URLs and UTM parameters
Integrates with:
- Amazon Associates (commission: 1-10%)
- ShareASale (1000+ merchants)
- Impact (enterprise tracking)
- CJ Affiliate (B2B focus)
- Custom affiliate networks (paste your own links)

3. FTC Compliance Automation

Generates legally-reviewed disclosure statements
Places disclosures prominently (top of post, before first link)
Adds visual indicators: badges, icons, or inline notices
Tracks which links have disclosures (audit trail)
Generates compliance reports for legal review
Supports multiple disclosure standards:
- FTC Endorsement Guides (US)
- AANA Code of Ethics (Australia)
- ASA Guidelines (UK)
- DGPR considerations (EU)

4. Content-Aware Link Injection

Analyzes context to place links naturally (not spammy)
Limits links per 1000 words (default: 3-5 links)
Avoids linking competitor products negatively
Preserves original anchor text or suggests better SEO variants
Respects nofollow requirements for sponsored content

5. Multi-Format Support

Markdown: Direct link injection with metadata
HTML: Wraps links with data attributes for tracking
WordPress: Injects via REST API with post scheduling
Google Docs: Suggests links in comments for approval workflow
Substack: Formats links for newsletter compatibility
Plain Text: Generates separate link mapping file

6. Reporting & Analytics

Generates monetization opportunity reports
Shows estimated revenue per post
Tracks link click-through rates (requires analytics integration)
Compliance audit logs
Competitor link analysis

Configuration

Required Environment Variables

bash

# Affiliate Network Credentials
export AFFILIATE_NETWORKS_API_KEY="your_api_key_here"
export AMAZON_ASSOCIATES_ID="yourname-20"
export SHARESALE_MERCHANT_ID="your_merchant_id"

# FTC Compliance Settings
export FTC_COMPLIANCE_MODE="strict"  # strict, moderate, minimal
export DISCLOSURE_PLACEMENT="top"    # top, sidebar, inline, footer
export DISCLOSURE_LANGUAGE="en-US"   # en-US, en-GB, en-AU, de-DE, etc.

# Content Analysis
export LINK_DENSITY_MAX="5"          # Max links per 1000 words
export MIN_PRODUCT_RELEVANCE="0.75"  # 0-1 scale (1 = perfect match)
export AUTO_INJECT="false"           # true = inject, false = suggest only

Setup Instructions

Get API Keys:
- Amazon Associates: https://affiliate-program.amazon.com/
- ShareASale: https://www.shareasale.com/
- Impact: https://impact.com/
- CJ Affiliate: https://www.cjaffiliates.com/

Set Environment Variables:

bash

export AFFILIATE_NETWORKS_API_KEY="your_key"
export FTC_COMPLIANCE_MODE="strict"

Connect Your Platform:
- WordPress: Generate REST API token at Settings → Users
- Google Docs: Share document and authenticate with your Google account
- Slack: Install bot and authorize channel access

Test with Sample Content:

text

Run: affiliate-link-injector --test --mode=suggest
Input: "I recommend the iPhone 14 Pro and iPad Air"
Output: Suggested links with compliance check

Example Outputs

Output 1: Injected Blog Post (Markdown)

markdown

# Best Budget Laptops in 2024

*Disclosure: This post contains affiliate links. We earn a commission 
if you click and purchase at no additional cost to you.*

## Budget Champion: ASUS VivoBook 15

The [ASUS VivoBook 15](https://amazon.com/s?k=ASUS+VivoBook+15&tag=yourname-20) 
offers excellent value at under $500. With a Ryzen 5 processor and 
16GB RAM, it handles everyday tasks effortlessly.

**Affiliate Networks Used**: Amazon Associates
**Commission Rate**: 4%
**Estimated Revenue Per Sale**: $20

Output 2: Monetization Opportunity Report

text

AFFILIATE LINK INJECTOR REPORT
Generated: 2024-01-15

Post: "Top 10 Photography Gadgets"
Current Links: 2
Monetization Opportunities: 8 new products
Estimated Revenue Potential: $450-$800/month

Products Found:
✓ Canon EOS R6 → Amazon (10%), B&H Photo (8%)
✓ Nikon Z9 → Amazon (10%), Adorama (7%)
✓ Sony A7IV → Amazon (10%), Newegg (6%)
✓ DJI Air 3S → Amazon (5%), Best Buy (4%)
✓ Peak Design Backpack → Amazon (8%), REI (6%)

FTC Compliance Status: APPROVED
Disclosure Placement: Top of post
Risk Assessment: LOW (all links contextualized)

Output 3: Compliance Audit Log

text

COMPLIANCE AUDIT TRAIL

Post ID: 42
Post Title: "Best Wireless Earbuds 2024"
Scan Date: 2024-01-15 10:30 UTC

Links Injected: 5
├─ AirPods Pro → Amazon (FTC disclosed: YES)
├─ Sony WF-1000XM5 → Amazon (FTC disclosed: YES)
├─ Jabra Elite 85t → ShareASale (FTC disclosed: YES)
├─ Bose QuietComfort → Amazon (FTC disclosed: YES)
└─ Anker Soundcore → Amazon (FTC disclosed: YES)

Disclosure Statement: Present
Disclosure Visibility: High (top of post)
Regulatory Compliance: ✓ FTC (US), ✓ ASA (UK), ✓ AANA (AU)
Risk Level: LOW
Recommended Review: None

Tips & Best Practices

1. Maximize Revenue Without Compromising Readers

Link only products you genuinely recommend (credibility = click-through)
Use "Use when the user needs..." language in product descriptions
Limit to 3-5 links per 1000 words (optimal for engagement)
Test different disclosure placements (top vs. inline)

2. Optimize for Search Engines

Use natural anchor text: "the ASUS VivoBook 15" not "click here"
Keep affiliate URLs clean (remove tracking parameters that hurt SEO)
Add product schema markup for rich snippets
Interlink related posts to boost domain authority

3. FTC Compliance Best Practices

Use "Disclosure" not "Disclaimer" (clearer for readers)
Place disclosure BEFORE the first affiliate link
Use clear language: "We earn a commission" not "We may earn a commission"
Document your affiliate relationships in a separate page
Review FTC updates quarterly (https://www.ftc.gov/endorsements)

4. A/B Test Link Placement

Compare performance: top disclosure vs. inline notices
Track which products generate highest CTR
Test different link colors/styles (if using custom CSS)
Monitor bounce rates to ensure links don't distract

5. Maintain Reader Trust

Disclose ALL affiliate relationships (not just some)
Link competitors fairly if you mention them
Update links quarterly (broken links hurt credibility)
Be transparent about commission rates (optional but builds trust)

6. Integrate with Analytics

Use UTM parameters: ?utm_source=blog&utm_medium=affiliate&utm_campaign=post-title
Track conversions in Google Analytics or your affiliate dashboard
Measure ROI per post to identify high-performing content
Adjust link strategy based on performance data

Safety & Guardrails

What This Skill Will NOT Do

❌ Will NOT inject links without compliance review

Requires explicit approval or "suggest only" mode by default
Generates compliance reports for legal review before publishing

❌ Will NOT link to competitors in negative contexts

Detects comparative language and avoids unfair linking
Example: "Unlike the Product X, our choice..." → Skips link

❌ Will NOT exceed ethical link density

Hard limit: 5 links per 1000 words (configurable)
Flags content as "over-monetized" if density exceeds threshold
Prevents spammy affiliate content that harms reader experience

❌ Will NOT link to prohibited categories

Respects your custom blocklist (weapons, adult content, etc.)
Automatically filters based on FTC guidelines
Prevents linking to competitors' affiliate programs

❌ Will NOT work without explicit user content

Requires you to provide content (won't scrape web)
Respects copyright and intellectual property
Requires API authentication for WordPress/platform integrations

❌ Will NOT guarantee affiliate program approval

Some networks (Amazon Associates) have strict policies
Your account must be approved independently
Skill generates compliant links but doesn't bypass network restrictions

Limitations

Network Coverage: ~500 affiliate networks supported; niche products may not have affiliate options
Language Support: Optimized for English; other languages have reduced accuracy
Real-Time Updates: Affiliate commission rates updated monthly (not real-time)
Link Verification: Does not verify if products are currently in stock or available
Revenue Guarantees: Estimated earnings are approximations based on average conversion rates

Troubleshooting

Issue 1: "No Affiliate Links Found for Product X"

Cause: Product not in supported affiliate networks

Solutions:

Check if the product has an affiliate program directly (contact brand)
Use a fallback network (Amazon Associates for most products)
Add a custom affiliate link manually
Adjust MIN_PRODUCT_RELEVANCE setting lower (0.5-0.7)

bash

affiliate-link-injector --product="Obscure Product" --fallback=amazon

Issue 2: "FTC Disclosure Not Appearing in Output"

Cause: Disclosure placement setting or content format incompatibility

Solutions:

Verify DISCLOSURE_PLACEMENT is set correctly:

bash

export DISCLOSURE_PLACEMENT="top"  # or "inline", "footer", "sidebar"

Check content format supports disclosure (HTML/Markdown required):
text
```
affiliate-link-injector --format=markdown --disclosure=top
```
For WordPress, ensure theme supports custom HTML blocks

Issue 3: "Links Injected But Analytics Not Tracking"

Cause: UTM parameters missing or affiliate network not configured

Solutions:

Verify affiliate network API key is active:
bash
```
affiliate-link-injector --test-api
```

Enable UTM parameter generation:

bash

export UTM_ENABLED="true"
export UTM_SOURCE="blog"
export UTM_MEDIUM="affiliate"

Check your affiliate dashboard for conversion tracking setup

Issue 4: "Too Many Links Injected (Over-Monetized)"

Cause: Link density exceeds recommended threshold

Solutions:

Reduce LINK_DENSITY_MAX:

bash

export LINK_DENSITY_MAX="3"  # Changed from 5 to 3

Use "suggest only" mode to review before injecting:
text
```
affiliate-link-injector --mode=suggest --review=true
```
Manually remove lower-priority links

Affiliate Link Injector

Install

Overview

Why This Matters

Integrations

Quick Start

Example 1: Scan Blog Post and Inject Amazon Links

Example 2: Monetize Product Review with Multiple Networks

Example 3: Bulk Scan WordPress Posts for Monetization Opportunities

Example 4: Create FTC-Compliant Disclosure Variants

Capabilities

1. Intelligent Product Detection

2. Affiliate Network Matching

3. FTC Compliance Automation

4. Content-Aware Link Injection

5. Multi-Format Support

6. Reporting & Analytics

Configuration

Required Environment Variables

Setup Instructions

Example Outputs

Output 1: Injected Blog Post (Markdown)

Output 2: Monetization Opportunity Report

Output 3: Compliance Audit Log

Tips & Best Practices

1. Maximize Revenue Without Compromising Readers

2. Optimize for Search Engines

3. FTC Compliance Best Practices

4. A/B Test Link Placement

5. Maintain Reader Trust

6. Integrate with Analytics

Safety & Guardrails

What This Skill Will NOT Do

Limitations

Troubleshooting

Issue 1: "No Affiliate Links Found for Product X"

Issue 2: "FTC Disclosure Not Appearing in Output"

Issue 3: "Links Injected But Analytics Not Tracking"

Issue 4: "Too Many Links Injected (Over-Monetized)"

Issue 5: "WordPress Integration Not Working