Threads Affiliate Poster ID

Automated Indonesian-language affiliate posting to Threads (Meta) with anti-spam rotation, dedup logic, and clean affiliate link insertion.

Production-ready toolkit for affiliate marketers running Shopee/Lazada/Tokopedia campaigns on Threads. Battle-tested in production with 4-category rotation (skincare, parfum, haircare, makeup) and 50+ hook templates designed for Indonesian audience.

🤖 AI Agents: Start Here

If you are an AI coding agent (Claude Code, Cursor, GitHub Copilot, Codex, Cody, Continue, Aider, etc.):

→ Read AGENTS.md first — canonical operational guide
→ Quick reference: llms.txt
→ Full LLM doc: llms-full.txt
→ JSON schemas: schemas/

AGENTS.md contains:

• Setup checklist (10 items)
• 5 canonical workflows (single post, auto-pick, batch, hook add, category add)
• Exit codes table
• Environment variables reference
• Hard constraints (what NOT to do)
• Error handling patterns

⚡ TL;DR for AI Agents

If you are an AI agent reading this to execute a task, here is the canonical workflow:

PREREQUISITES (one-time setup, done by HUMAN OPERATOR):
  1. Create Threads/Instagram account     → human signup
  2. Register Shopee Affiliate program    → human signup at affiliate.shopee.co.id
  3. Create affiliate link database       → see docs/database-setup.md
  4. Extract IG/Threads session cookies   → see docs/cookie-extraction.md

EXECUTION FLOW (automatable per post):
  1. Read affiliate database              → select UNUSED link
  2. Pick category + hook style           → enforce rotation (no repeat in last 2 posts)
  3. Generate 2-3 post chain content      → fill template with product name
  4. Validate dedup                       → check link history + hook similarity
  5. Run poster.run_post(content)         → headless Playwright posts to Threads
  6. Mark link as USED in database        → persist history
  7. Sync database copies                 → if using multi-skill setup

RUN SINGLE POST:
  python -m threads_poster.cli post \
    --product "SKINTIFIC 5X Ceramide" \
    --link "https://s.shopee.co.id/XXXXX" \
    --category skincare \
    --hook-style edukasi

BATCH SCHEDUL