c309581df0
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>
42 lines
1.7 KiB
Markdown
42 lines
1.7 KiB
Markdown
# 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
|