Affiliate Agents Project

Purpose & architecture

A distributed affiliate tracking system with 1,000 unique agent pages, each with QR code support for easy mobile access.

This page records a pinned branch snapshot. Differences are compared with the audited default branch, not assumed to be chronological improvements. Author claims in the source documentation are retained as claims. Source recovery does not establish successful deployment, scientific validity, or equivalence with another branch.

This source generation

This record follows the claude/scan-dna-project-chat-011CUdr6fHJi6cHngT3LDS13 branch of Janady13/affiliate-agents at commit 7072bc0d17e6969baf6ffcc052dc128b698b8eba. The snapshot identifies the source inspected in this audit. It is not a statement about which revision is currently running on a device.

Field	Source record
Revision	7072bc0d17e6969baf6ffcc052dc128b698b8eba
Branch	claude/scan-dna-project-chat-011CUdr6fHJi6cHngT3LDS13
Recorded generation	Preserved branch generation

Recovered implementation structure

These paths locate the components and entry points represented by this build. The source register contains their inspected revisions.

README.md
index.html
scripts/generate-agents.sh
scripts/setup-linux.sh
scripts/setup-macos.sh

Behavior & verification limits

Read-only source inspection. No native engine, generator, database, payment, or production service was executed.

Original project documentation

The following documentation is preserved as a dated source account. Claims in it retain the source’s wording and must be read alongside the implementation notes above.

A distributed affiliate tracking system with 1,000 unique agent pages, each with QR code support for easy mobile access.

Overview

This project creates individual tracking pages for affiliate marketing campaigns. Each agent (AGENT4001 through AGENT5000) has: - A dedicated HTML landing page - A unique QR code for mobile tracking - Individual affiliate tracking parameters

Features

1,000 unique agent pages
QR code generation for each agent
GitHub Pages ready deployment
Mobile-responsive design
Simple affiliate link tracking

Installation

Prerequisites

Git
A GitHub account
Web browser (for testing)

Quick Start

macOS Installation

# Clone the repository
git clone https://github.com/Janady13/affiliate-agents.git
cd affiliate-agents

# Run the setup script
chmod +x scripts/setup-macos.sh
./scripts/setup-macos.sh

Linux Installation

# Clone the repository
git clone https://github.com/Janady13/affiliate-agents.git
cd affiliate-agents

# Run the setup script
chmod +x scripts/setup-linux.sh
./scripts/setup-linux.sh

Manual Installation

Clone this repository:

   git clone https://github.com/Janady13/affiliate-agents.git
   cd affiliate-agents

2. Enable GitHub Pages: - Go to your repository settings on GitHub - Navigate to "Pages" section - Select branch: main (or your default branch) - Select folder: / (root) - Click "Save"

Your site will be available at:

   https://janady13.github.io/affiliate-agents/

Usage

Accessing Agent Pages

Each agent has a unique URL:

https://janady13.github.io/affiliate-agents/AGENT4001/
https://janady13.github.io/affiliate-agents/AGENT4002/
...
https://janady13.github.io/affiliate-agents/AGENT5000/

Customizing Affiliate Links

To customize the affiliate offer URLs:

Edit the agent HTML files
Replace https://example.com/offer?sid=AGENTXXXX with your actual affiliate URL
Update the tracking pixel if needed

Example:

<a href="https://your-affiliate-network.com/offer?sid=AGENT4001" target="_blank" rel="noopener noreferrer">
  Your Offer
</a>

Generating New Agents

Use the provided generator script:

# Generate new agents
chmod +x scripts/generate-agents.sh
./scripts/generate-agents.sh 5001 5100  # Creates AGENT5001 to AGENT5100

Project Structure

affiliate-agents/
├── .nojekyll              # Tells GitHub Pages not to use Jekyll
├── .gitignore             # Git ignore rules
├── README.md              # This file
├── index.html             # Main landing page (optional)
├── scripts/               # Utility scripts
│   ├── setup-macos.sh     # macOS setup script
│   ├── setup-linux.sh     # Linux setup script
│   └── generate-agents.sh # Agent generation script
└── AGENT4001/             # Agent folders (4001-5000)
    ├── index.html         # Agent landing page
    └── qr.png             # QR code for agent

GitHub Pages Configuration

The repository is configured to work with GitHub Pages out of the box:

The .nojekyll file ensures proper serving of folders starting with underscores or dots
All agent pages are self-contained with no build process required
Static HTML ensures fast loading and high reliability

Tracking and Analytics

To add tracking to your affiliate pages:

Google Analytics: Add your GA4 tracking code to each agent page
Facebook Pixel: Add your pixel code to track conversions
Custom Tracking: Implement your own tracking parameters

Example for Google Analytics:

<!-- Add to each agent's index.html before </body> -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'GA_MEASUREMENT_ID');
</script>

Development

Local Testing

You can test locally using any simple HTTP server:

Python 3

python3 -m http.server 8000

Python 2

python -m SimpleHTTPServer 8000

Node.js

npx http-server -p 8000

Then visit http://localhost:8000/AGENT4001/ to test an agent page.

Deployment

Automated Deployment

Changes pushed to the main branch will automatically deploy to GitHub Pages.

git add .
git commit -m "Update agent pages"
git push origin main

Manual Deployment

GitHub Pages automatically serves the content from your repository. No manual deployment steps are needed beyond pushing your changes.

Troubleshooting

Pages Not Loading

Verify GitHub Pages is enabled in repository settings
Check that the source branch is correct
Wait 1-2 minutes for GitHub to build and deploy changes
Clear browser cache and try again

QR Codes Not Displaying

Ensure qr.png files exist in each agent folder
Check file permissions are correct
Verify image files are properly committed to git

Custom Domain Issues

If using a custom domain: 1. Add CNAME record pointing to janady13.github.io 2. Create CNAME file in repository root with your domain 3. Enable HTTPS in GitHub Pages settings

Security Considerations

All affiliate links use rel="noopener noreferrer" for security
No user data is collected or stored by this system
Tracking is handled by external affiliate networks

Performance

Lightweight HTML pages load in <100ms
No JavaScript frameworks required
Optimized for mobile devices
QR codes enable instant mobile access

Contributing

Fork the repository
Create a feature branch: git checkout -b feature-name
Commit changes: git commit -am 'Add feature'
Push to branch: git push origin feature-name
Submit a pull request

License

This project is provided as-is for affiliate marketing purposes.

Support

For issues and questions: - Open an issue on GitHub - Check existing documentation - Review GitHub Pages documentation

Changelog

Version 1.0.0 (2025-10-30) - Initial release with 1,000 agent pages - GitHub Pages integration - QR code support - macOS and Linux installation scripts

Roadmap

[ ] Custom domain support documentation
[ ] Bulk agent generation tool
[ ] Analytics dashboard
[ ] A/B testing framework
[ ] Mobile app integration

Built with GitHub Pages | Deployed at: https://janady13.github.io/affiliate-agents/

Sources & provenance

Janady13/affiliate-agents / README.md

· 7072bc0d17e6

Read the architecture

Purpose & architecture

This source generation

Recovered implementation structure

Behavior & verification limits

Original project documentation