一份完整的、经过实战考验的指南和工具包，通过API发布到Meta Threads——以Claude代码技能的形式发布。

包含设置流程、多帖线程（含图片）、可执行脚本以及针对AI驱动工作流程的Chrome自动化指南。

---

特色

• 完整设置流程 — 从创建元应用到获取长效令牌（60天）
• 多帖帖子串 — 带有reply_to_id的链条，混合文本和图片
• 图片支持 — 上传至公共网址（catbox.moe）+ 通过[[T1]附加]
• 可执行脚本 — post-thread.sh 可与 .env 凭证一起使用
• Chrome 自动化指南 — 适用于 Claude Code 和 OpenAI Codex
• 陷阱文档 — 每步遇到并记录的10+个真实陷阱

---

快速启动

1.克隆与配置

2.发帖讨论

3.作为克劳德代码技能的使用

将.claude/skills/threads-api/文件夹复制到你的项目中：

然后用Claude代码调用：

---

文件结构

---

线程 API 概述

认证流程

出版流程

关键终点

Threads API Skill for Claude Code

A complete, battle-tested guide and toolkit for publishing to Meta Threads via API — packaged as a Claude Code Skill.

Includes setup flow, multi-post threading with images, executable scripts, and Chrome automation guides for AI-driven workflows.

---

Features

• Full setup flow — from creating a Meta App to obtaining a long-lived token (60-day)
• Multi-post threads — chain posts with reply_to_id, mix text and images
• Image support — upload to public URL (catbox.moe) + attach via image_url
• Executable script — post-thread.sh ready to use with .env credentials
• Chrome automation guides — for both Claude Code and OpenAI Codex
• Pitfall documentation — 10+ real pitfalls encountered and documented at each step

---

Quick Start

1. Clone and configure

git clone https://github.com/PRODUCTIVITYENHANCE/threads-api-skill.git
cd threads-api-skill

# Copy and fill in your credentials
cp .env.example .env
# Edit .env with your THREADS_APP_ID, THREADS_APP_SECRET, THREADS_USER_ID, THREADS_ACCESS_TOKEN

2. Post a thread

# Edit content in post-thread.sh, then:
chmod +x post-thread.sh
./post-thread.sh

3. Use as Claude Code Skill

Copy the .claude/skills/threads-api/ folder into your project:

cp -r .claude/skills/threads-api/ YOUR_PROJECT/.claude/skills/threads-api/

Then invoke in Claude Code:

/threads-api

---

File Structure

.
├── README.md
├── .env.example              ← Credential template
├── post-thread.sh            ← Executable posting script
└── .claude/skills/threads-api/
    ├── SKILL.md              ← Skill entry point
    ├── setup.md              ← Full setup flow + 10 pitfalls
    ├── post-thread.md        ← Thread posting guide + 7 pitfalls
    ├── post-thread.sh        ← Script (also in skill folder)
    ├── chrome-setup-claude.md ← Claude Code × Chrome guide
    └── chrome-setup-codex.md  ← Codex × Chrome guide

---

Threads API Overview

Authentication Flow

Create Meta App → Add Tester → Accept Invitation
→ Graph API Explorer (switch to .threads.net/)
→ Generate Short-lived Token (1 hour)
→ Exchange for Long-lived Token (60 days)

Publishing Flow

Create Container (text/image) → Wait 30s → Publish
                                              ↓
Create Reply Container (reply_to_id) → Wait 30s → Publish

Key Endpoints

---

Critical Pitfalls

These are real issues encountered during development — not hypothetical: