Skip to content

Commit cad7647

Browse files
DavidsonGomesclaude
DavidsonGomes
and
claude
committed
docs: add 11 missing integration guides (now 19 total)
Omie, Fathom, Todoist, Telegram, WhatsApp, YouTube, Instagram, LinkedIn, Linear, Obsidian, Licensing. Updated overview with all 19 integrations organized by category. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 5034c1f commit cad7647

13 files changed

Lines changed: 1620 additions & 14 deletions

File tree

‎docs/integrations/fathom.md‎

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# Fathom Integration
2+
3+
Fathom records and transcribes meetings, providing summaries, transcripts, and action items. The @clawdia agent uses Fathom to keep track of discussions, decisions, and follow-ups across all calls.
4+
5+
## Setup
6+
7+
### 1. Get Your API Key
8+
9+
1. Go to [fathom.video](https://fathom.video)
10+
2. Navigate to **Settings > API**
11+
3. Copy your API key (requires Fathom Team or Enterprise plan)
12+
13+
### 2. Configure .env
14+
15+
```env
16+
FATHOM_API_KEY=your_api_key_here
17+
```
18+
19+
### 3. Test the Connection
20+
21+
```bash
22+
make sync
23+
```
24+
25+
This fetches recent meetings from Fathom, saves transcripts and summaries locally, and updates the meeting index.
26+
27+
## Available Commands
28+
29+
The `int-fathom` skill queries the Fathom API via a shell script:
30+
31+
| Command | What it does |
32+
|---|---|
33+
| `meetings` | List recent meetings |
34+
| `meetings --include-summary` | List meetings with AI summaries |
35+
| `meetings --include-actions` | List meetings with action items |
36+
| `meetings --include-transcript` | List meetings with full transcripts |
37+
| `meetings --after DATE --before DATE` | Filter by date range |
38+
| `meetings --recorded-by EMAIL` | Filter by recorder |
39+
| `meetings --team NAME` | Filter by team |
40+
| `summary RECORDING_ID` | Get summary for a specific recording |
41+
| `transcript RECORDING_ID` | Get transcript for a specific recording |
42+
| `teams` | List teams |
43+
| `members` | List team members |
44+
45+
## Key Data Points
46+
47+
- Meeting title, date, duration, and participants
48+
- AI-generated summaries (markdown formatted)
49+
- Action items with assignees
50+
- Full transcripts with speaker labels
51+
- Team and participant filtering
52+
53+
## Skills That Use Fathom
54+
55+
| Skill | What it does |
56+
|---|---|
57+
| `int-fathom` | Direct Fathom API queries -- meetings, summaries, transcripts |
58+
| `int-sync-meetings` | Full sync pipeline -- fetch, deduplicate, save, and index meetings |
59+
60+
## Automated Routines
61+
62+
| Routine | Schedule | Make command |
63+
|---|---|---|
64+
| Sync Meetings | Every 30 min | `make sync` |

‎docs/integrations/instagram.md‎

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
# Instagram Integration
2+
3+
Instagram Graph API provides profile statistics, post engagement, reach, and impressions. The @pixel agent uses it for social media analytics. Supports multiple accounts via OAuth through Facebook.
4+
5+
## Setup
6+
7+
### 1. Create a Facebook App
8+
9+
1. Go to [developers.facebook.com](https://developers.facebook.com)
10+
2. Create a new app (type: Business)
11+
3. Navigate to **Settings > Basic**
12+
4. Copy your **App ID** and **App Secret**
13+
14+
### 2. Configure .env
15+
16+
```env
17+
META_APP_ID=your_app_id_here
18+
META_APP_SECRET=your_app_secret_here
19+
```
20+
21+
### 3. Connect Your Account
22+
23+
```bash
24+
make social-auth
25+
```
26+
27+
Open the dashboard Integrations page and click **Connect** on Instagram. Complete the Facebook OAuth flow. The Instagram Business/Creator account linked to your Facebook Page will be connected.
28+
29+
### 4. Test the Connection
30+
31+
```bash
32+
make social
33+
```
34+
35+
## Available Commands
36+
37+
The `int-instagram` skill queries the Instagram Graph API:
38+
39+
| Command | What it does |
40+
|---|---|
41+
| `accounts` | List configured Instagram accounts |
42+
| `profile [account]` | Followers, bio, media count |
43+
| `recent_posts [account] [N]` | Last N posts with engagement |
44+
| `top_posts [account] [N]` | Top N posts by engagement |
45+
| `post_insights POST_ID` | Detailed insights for a specific post |
46+
| `account_insights [account]` | Impressions, reach, profile views (30 days) |
47+
| `summary` | Summary across all accounts |
48+
49+
## Key Metrics
50+
51+
- Followers (delta via daily snapshots)
52+
- Engagement rate: (likes + comments) / followers
53+
- Reach and impressions
54+
- Profile views
55+
- Best post of the period
56+
- Reels vs static post performance
57+
- Publishing frequency
58+
59+
## Rate Limits
60+
61+
- Platform endpoints: 4800 calls per 24 hours
62+
- Business Discovery / Hashtag: 200 calls per hour per user
63+
64+
## Skills That Use Instagram
65+
66+
| Skill | What it does |
67+
|---|---|
68+
| `int-instagram` | Direct Instagram Graph API queries |
69+
| `social-instagram-report` | Instagram analytics HTML report |
70+
| `social-analytics-report` | Cross-platform analytics (includes Instagram) |
71+
72+
## Automated Routines
73+
74+
| Routine | Schedule | Make command |
75+
|---|---|---|
76+
| Social Analytics | 18:00 BRT daily | `make social` |
77+
| Social Weekly | Friday 08:15 BRT | `make social` |
78+
| Social Monthly | 1st of month | `make social` |

‎docs/integrations/licensing.md‎

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# Licensing Integration
2+
3+
The Evolution Licensing API provides telemetry and growth metrics for the open source ecosystem. The @atlas agent uses it to track active instances, geographic distribution, version adoption, and commercial alerts.
4+
5+
## Setup
6+
7+
### 1. Get Your Admin Token
8+
9+
Contact the Evolution team to obtain a Licensing API admin token.
10+
11+
### 2. Configure .env
12+
13+
```env
14+
LICENSING_ADMIN_TOKEN=your_token_here
15+
```
16+
17+
### 3. Test the Connection
18+
19+
```bash
20+
make licensing
21+
```
22+
23+
This runs the daily licensing report, querying 24-hour telemetry data.
24+
25+
## Available Commands
26+
27+
The `int-licensing` skill queries the Licensing API via a Python client:
28+
29+
| Command | What it does |
30+
|---|---|
31+
| `keys [--status --tier]` | List license keys with optional filters |
32+
| `instances [--status --tier --geo --heartbeat]` | List active instances |
33+
| `instance_detail ID` | Detailed info for a specific instance |
34+
| `telemetry --period 24h/7d/30d` | Telemetry summary for a period |
35+
| `activation_log [--api_key KEY]` | Activation history |
36+
| `alerts [--resolved false]` | Commercial alerts (expiring, overuse) |
37+
| `customers [--search --country --tier]` | Customer list with filters |
38+
| `customer_detail ID` | Detailed customer info |
39+
| `products` | List available products |
40+
41+
## Key Metrics
42+
43+
| Metric | What it measures |
44+
|---|---|
45+
| Active instances | Total adoption (heartbeat coverage) |
46+
| Heartbeat 24h | Instances actually running right now |
47+
| Geographic distribution | Where users are located |
48+
| Version distribution | Adoption of new releases |
49+
| Messages sent | Real usage volume |
50+
| Feature usage | Which features matter most |
51+
| Daily message trend | Growth curve over time |
52+
| Commercial alerts | License issues requiring attention |
53+
54+
## Skills That Use Licensing
55+
56+
| Skill | What it does |
57+
|---|---|
58+
| `int-licensing` | Direct Licensing API queries |
59+
| `prod-licensing-daily` | Daily open source growth report (HTML) |
60+
| `prod-licensing-weekly` | Weekly growth report with trend analysis |
61+
| `prod-licensing-monthly` | Monthly comprehensive growth report |
62+
63+
## Automated Routines
64+
65+
| Routine | Schedule | Make command |
66+
|---|---|---|
67+
| Licensing Daily | 18:30 BRT daily | `make licensing` |
68+
| Licensing Weekly | Friday 07:45 BRT | `make licensing-weekly` |
69+
| Licensing Monthly | 1st of month | `make licensing-month` |

‎docs/integrations/linear.md‎

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
# Linear Integration
2+
3+
Linear is used for issue tracking, sprint management, and project planning. The @atlas agent monitors issues, blockers, sprint progress, and review queues via the Linear MCP server.
4+
5+
## Setup
6+
7+
### 1. Configure MCP
8+
9+
Linear connects through an MCP server (`linear-server`) configured in `.claude/settings.json`. Claude Code starts it automatically when Linear tools are needed.
10+
11+
No `.env` variables are required -- the MCP server handles authentication through its own configuration.
12+
13+
### 2. Test the Connection
14+
15+
```bash
16+
make linear
17+
```
18+
19+
This runs the Linear review routine, which checks issues in review, blockers, stale items, and sprint progress.
20+
21+
## Available Tools
22+
23+
The Linear MCP server exposes these tools:
24+
25+
| Tool | What it does |
26+
|---|---|
27+
| `list_issues` | List issues with filters (state, assignee, priority) |
28+
| `get_issue` | Get details of a specific issue |
29+
| `save_issue` | Create or update an issue |
30+
| `list_projects` | List all projects |
31+
| `get_project` | Get project details |
32+
| `list_cycles` | List sprints/cycles (current, past, future) |
33+
| `list_teams` | List teams |
34+
| `list_users` | List team members |
35+
| `list_comments` | List comments on an issue |
36+
| `save_comment` | Add a comment to an issue |
37+
| `list_milestones` | List milestones |
38+
| `research` | Search across Linear data |
39+
40+
## Key Metrics
41+
42+
The `int-linear-review` skill analyzes:
43+
44+
- **In Review:** Issues awaiting review, who needs to review, days pending
45+
- **Blockers:** Urgent and high-priority issues with responsible assignees
46+
- **Stale issues:** In Progress items with no updates in 3+ days
47+
- **My issues:** User's assigned issues sorted by priority
48+
- **Sprint progress:** Completion percentage and deadline
49+
50+
## Skills That Use Linear
51+
52+
| Skill | What it does |
53+
|---|---|
54+
| `int-linear-review` | Review issues, blockers, stale items, sprint progress |
55+
| `evo-sprint-planning` | Generate sprint plans from epics |
56+
| `evo-sprint-status` | Sprint status summary with risks |
57+
58+
## Automated Routines
59+
60+
| Routine | Schedule | Make command |
61+
|---|---|---|
62+
| Linear Review | Mon/Wed/Fri 09:00 BRT | `make linear` |

‎docs/integrations/linkedin.md‎

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
# LinkedIn Integration
2+
3+
LinkedIn API provides profile information and organization statistics. The @pixel agent uses it for social media analytics. Supports multiple accounts via OAuth.
4+
5+
## Setup
6+
7+
### 1. Create a LinkedIn App
8+
9+
1. Go to [linkedin.com/developers](https://www.linkedin.com/developers/)
10+
2. Create a new app
11+
3. Navigate to **Auth** tab
12+
4. Copy your **Client ID** and **Client Secret**
13+
14+
### 2. Configure .env
15+
16+
```env
17+
LINKEDIN_CLIENT_ID=your_client_id_here
18+
LINKEDIN_CLIENT_SECRET=your_client_secret_here
19+
```
20+
21+
### 3. Connect Your Account
22+
23+
```bash
24+
make social-auth
25+
```
26+
27+
Open the dashboard Integrations page and click **Connect** on LinkedIn. Complete the OAuth flow.
28+
29+
### 4. Test the Connection
30+
31+
```bash
32+
make social
33+
```
34+
35+
## Available Commands
36+
37+
The `int-linkedin` skill queries the LinkedIn API:
38+
39+
| Command | What it does |
40+
|---|---|
41+
| `accounts` | List configured LinkedIn accounts |
42+
| `profile [account]` | Name, email, photo |
43+
| `my_posts [account] [N]` | Recent posts (requires `w_member_social` scope) |
44+
| `post_stats POST_URN` | Reactions and comments on a post |
45+
| `org_followers [account]` | Organization followers (requires Advertising API) |
46+
| `summary` | Summary across all accounts |
47+
48+
## Available Scopes
49+
50+
| Scope | Status | LinkedIn Product |
51+
|---|---|---|
52+
| `openid profile email` | Active | Sign In with OpenID Connect |
53+
| `w_member_social` | Active | Share on LinkedIn |
54+
| `r_organization_social` | Pending | Advertising API (requires approval) |
55+
| `r_organization_admin` | Pending | Advertising API (requires approval) |
56+
57+
## Current Limitations
58+
59+
- **Posts:** Reading posts requires the `w_member_social` scope
60+
- **Company Page analytics:** Requires Advertising API approval (pending)
61+
- **Workaround:** Export CSV from LinkedIn Analytics for Company Page data
62+
63+
## Skills That Use LinkedIn
64+
65+
| Skill | What it does |
66+
|---|---|
67+
| `int-linkedin` | Direct LinkedIn API queries |
68+
| `social-linkedin-report` | LinkedIn analytics HTML report |
69+
| `social-analytics-report` | Cross-platform analytics (includes LinkedIn) |
70+
71+
## Automated Routines
72+
73+
| Routine | Schedule | Make command |
74+
|---|---|---|
75+
| Social Analytics | 18:00 BRT daily | `make social` |
76+
| Social Weekly | Friday 08:15 BRT | `make social` |
77+
| Social Monthly | 1st of month | `make social` |

0 commit comments

Comments
 (0)