quorlasocial/README.md
metatroncubeswdev c309581df0 Initial commit: Quorla social media manager
Dashboard (content library, publishing queue with approvals, inbox, team
management, AI runs), Meta connector, branded PDF reports, agent skills,
and Docker packaging (Dockerfile, docker-compose with Caddy HTTPS,
backup and path-relocation scripts).

Client data, live data and secrets are excluded via .gitignore.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 13:02:29 -04:00

1.7 KiB

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