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