# 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:
   ```json
   "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
- [x] 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