Social Manager

Metatroncube's AI social media manager: Claude + client brand files + live Meta data + team task briefs.

Setup (Windows)

1. Install Node.js 20+ from nodejs.org.
2. Open .env and paste the system user token after META_SYSTEM_USER_TOKEN=.
3. Test the connection:

   cd connector
   npm install
   npm run test:meta
   

4. Use it from Claude Code in this folder (.mcp.json registers the social-manager tools automatically), or add to Claude Desktop's config:

   "social-manager": { "command": "node", "args": ["D:\\MCS_Repos\\2026\\claude_Metatron_Social_Media_Manager\\connector\\src\\server.js"] }
   

Folder map

• CLAUDE.md — the agent's job description and rules
• clients/<client>/ — brand, goals, constraints, history, calendars, reports
• playbooks/ — platform best practices
• team/ — roster and weekly task files
• .claude/skills/ — account-audit, weekly-plan, assign-tasks, weekly-report
• connector/ — MCP server for Facebook Pages + Instagram
• branding/ — Metatroncube logos + report styling
• dashboard/ — Social Command web app (clients, AI runs, PDFs, Odoo team board). See dashboard/README.md
• docs/ — Claude Desktop setup
• tools/report-pdf/ — turns report .md files into branded PDFs (node tools/report-pdf/build.mjs <file.md>)

Safety

• Publishing is off until ALLOW_PUBLISH=true in .env, and even then each post needs explicit approval.
• .env is git-ignored. Never share the token.

Roadmap

• Meta Pages + Instagram read + publish (approval-gated)
• Meta Ads (separate app, ads_read first)
• YouTube Data + Analytics API
• LinkedIn Community Management API
• Google Ads (MCC + developer token)
• Push tasks to Odoo Project