PiR2 Academy — Instagram Publisher

MCP แบบ local สำหรับคลาส Advanced Claude Cowork ใช้เตรียม preview และโพสต์ภาพหนึ่งภาพไป Instagram หลังผู้เรียนยืนยันอย่างชัดเจน

Safety contract

• รองรับ JPEG/PNG หนึ่งภาพต่อ post ใน core workshop
• ต้องสร้าง preview ก่อนทุกครั้ง
• โพสต์ได้เมื่อผู้เรียนตอบ ยืนยันโพสต์ หรือ Confirm post เท่านั้น
• token อยู่ใน credential vault ของ macOS/Windows และไม่อยู่ในไฟล์ MCPB
• Meta App Secret อยู่ที่ OAuth Broker เท่านั้น
• retry จะไม่สร้าง post ซ้ำโดยอัตโนมัติ

Development

Requires Node.js 20 or newer.

npm ci
npm run check

Learner flow

1. ติดตั้งไฟล์ .mcpb ใน Claude Desktop
2. ใช้ connect_instagram เพื่อ OAuth กับ Instagram Professional account ของตัวเอง
3. ให้ Canva official MCP export ภาพ JPEG/PNG หนึ่งภาพแบบ standard quality
4. ใช้ prepare_instagram_post เพื่อดู account, ภาพ และ caption ใน preview
5. ตรวจให้เรียบร้อย แล้วตอบ ยืนยันโพสต์ หรือ Confirm post
6. publish_instagram_post จะโพสต์ intent นั้นได้เพียงครั้งเดียวและคืน Media ID

Tools ที่ติดตั้ง:

• instagram_auth_status
• connect_instagram
• prepare_instagram_post
• publish_instagram_post

Supported core lab

• Instagram Professional account (Business หรือ Creator)
• JPEG/PNG หนึ่งภาพ ขนาดไม่เกิน 8 MB
• caption ไม่เกิน 2,200 ตัวอักษร
• macOS ARM64/Intel และ Windows ARM64/x64

ไม่รวม carousel, video, Reel, Story, schedule, analytics และ comments ใน core lab ไฟล์ export ต้องเป็น HTTPS URL ที่ Meta เข้าถึงได้และยังไม่หมดอายุ Publisher ตรวจ signed Canva export ด้วย ranged GET เพราะ URL ของ Canva ผูกกับ HTTP method และใช้ HEAD แทนไม่ได้

OAuth ใช้ PiR2 Academy broker ที่ https://meta-oauth.zie-agent.cloud/instagram เพื่อเก็บ Meta App Secret ไว้ฝั่ง server; access token ของผู้เรียนถูกส่งกลับแบบ PKCE-bound และเก็บใน credential vault ของเครื่องเท่านั้น

Built for PiR2 Academy — Advanced Claude Cowork.