How do I install the Bundle Social Analytics skill?

Run npx skillmds@latest add antongulin/bundle-social-analytics in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bundle Social Analytics safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bundle Social Analytics?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bundle Social Analytics free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bundle Social Analytics?

antongulin (@antongulin) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bundle Social Analytics by antongulin

Name: Bundle Social Analytics
Author: antongulin

Bundle Social Analytics

Retrieve and analyze social media performance metrics using the Bundle.social Analytics API. Use this skill when fetching analytics for social accounts or individual posts, getting raw metrics, bulk-comparing post performance, or forcing analytics refreshes on Bundle.social. Covers impressions, views, likes, comments, shares, saves, follower counts, engagement rates, and per-platform specific metrics. Supports date-range filtering, granularity control, and bulk post comparison. This skill should be triggered whenever a user mentions analytics, metrics, performance, engagement, impressions, or "how is my social media performing" in the context of Bundle.social.

antongulin f75991c 3 files · 8.7 KB Updated Sep 17, 2026

File contents

Author: Anton Gulin · Tool: opencode-skill-creator · GitHub: @antongulin · Registry: skills.sh

Bundle.social Analytics

This skill covers retrieving performance metrics for social accounts and posts on Bundle.social.

Authentication

x-api-key: <your-api-key>

Base URL: https://api.bundle.social

Reference Docs

Read references/README.md for platform enums and standard errors. Read references/07-analytics.md for endpoint details.

How to Use This Skill

When a user asks about social media analytics or performance data:

Determine scope — account-level analytics or post-level analytics
Identify time range — ask for dateFrom/dateTo if not provided
Read the reference doc for the specific endpoint
Generate curl command examples with <your-api-key> as placeholder (NEVER call the actual API)
Present the data clearly — highlight key metrics, trends, and comparisons

Analytics Data Structure

Account and post analytics share common metrics:

impressions, impressionsUnique — how many times content was seen
views, viewsUnique — video views where applicable
likes, comments, shares, saves — engagement actions
followerCount — audience growth
engagementRate — engagement relative to reach

Per-platform metrics may differ — YouTube has watch time, Instagram has story metrics, etc.

Endpoint Reference Summary

Account Analytics

GET /api/v1/analytics/social-account — Get analytics for a social account (supports dateFrom, dateTo, granularity)
GET /api/v1/analytics/social-account/raw — Get raw analytics data
POST /api/v1/analytics/social-account/force — Force refresh analytics

Post Analytics

GET /api/v1/analytics/post — Get analytics for a specific post
GET /api/v1/analytics/post/raw — Get raw analytics data for a post
GET /api/v1/analytics/post/bulk — Compare analytics for up to 60 posts at once
POST /api/v1/analytics/post/force — Force refresh post analytics

Common Patterns

Account health check: Get account analytics for last 30 days → Check trends in impressions and engagement
Post performance comparison: Use bulk endpoint with multiple postIds → Compare metrics side by side
Deep dive: Get post analytics → If interesting, get raw data for detailed analysis
Fresh data: If analytics seem stale, use force refresh → Wait → Re-fetch
Reporting: Pull account analytics with date range and granularity for weekly/monthly reports

Using the Bulk Analytics Endpoint

The bulk endpoint (GET /api/v1/analytics/post/bulk) is powerful for comparison:

Max 60 postIds per request, paginated 20 per page
Requires platformType — all posts must be from the same platform
Each result contains per-post metric arrays

Error Handling

Data may not be available immediately after posting — analytics update asynchronously
Force refresh has rate limits — don't spam it
Some metrics are platform-specific and may return null for platforms that don't support them

---name: bundle-social-analyticsdescription: Retrieve and analyze social media performance metrics using the Bundle.social Analytics API. Use this skill when fetching analytics for social accounts or individual posts, getting raw metrics, bulk-comparing post performance, or forcing analytics refreshes on Bundle.social. Covers impressions, views, likes, comments, shares, saves, follower counts, engagement rates, and per-platform specific metrics. Supports date-range filtering, granularity control, and bulk post comparison. This skill should be triggered whenever a user mentions analytics, metrics, performance, engagement, impressions, or "how is my social media performing" in the context of Bundle.social.---> **Author**: Anton Gulin · **Tool**: [opencode-skill-creator](https://github.com/antongulin/opencode-skill-creator) · **GitHub**: [@antongulin](https://github.com/antongulin) · **Registry**: [skills.sh](https://www.skills.sh/docs)# Bundle.social AnalyticsThis skill covers retrieving performance metrics for social accounts and posts on Bundle.social.## Authentication```x-api-key: <your-api-key>```Base URL: `https://api.bundle.social`## Reference DocsRead `references/README.md` for platform enums and standard errors.Read `references/07-analytics.md` for endpoint details.## How to Use This SkillWhen a user asks about social media analytics or performance data:1. **Determine scope** — account-level analytics or post-level analytics2. **Identify time range** — ask for `dateFrom`/`dateTo` if not provided3. **Read the reference doc** for the specific endpoint4. **Generate curl command examples** with `<your-api-key>` as placeholder (NEVER call the actual API)5. **Present the data clearly** — highlight key metrics, trends, and comparisons### Analytics Data StructureAccount and post analytics share common metrics:- `impressions`, `impressionsUnique` — how many times content was seen- `views`, `viewsUnique` — video views where applicable- `likes`, `comments`, `shares`, `saves` — engagement actions- `followerCount` — audience growth- `engagementRate` — engagement relative to reachPer-platform metrics may differ — YouTube has watch time, Instagram has story metrics, etc.## Endpoint Reference Summary### Account Analytics- `GET /api/v1/analytics/social-account` — Get analytics for a social account (supports `dateFrom`, `dateTo`, `granularity`)- `GET /api/v1/analytics/social-account/raw` — Get raw analytics data- `POST /api/v1/analytics/social-account/force` — Force refresh analytics### Post Analytics- `GET /api/v1/analytics/post` — Get analytics for a specific post- `GET /api/v1/analytics/post/raw` — Get raw analytics data for a post- `GET /api/v1/analytics/post/bulk` — Compare analytics for up to 60 posts at once- `POST /api/v1/analytics/post/force` — Force refresh post analytics## Common Patterns1. **Account health check**: Get account analytics for last 30 days → Check trends in impressions and engagement2. **Post performance comparison**: Use bulk endpoint with multiple postIds → Compare metrics side by side3. **Deep dive**: Get post analytics → If interesting, get raw data for detailed analysis4. **Fresh data**: If analytics seem stale, use force refresh → Wait → Re-fetch5. **Reporting**: Pull account analytics with date range and granularity for weekly/monthly reports## Using the Bulk Analytics EndpointThe bulk endpoint (`GET /api/v1/analytics/post/bulk`) is powerful for comparison:- Max 60 postIds per request, paginated 20 per page- Requires `platformType` — all posts must be from the same platform- Each result contains per-post metric arrays## Error Handling- Data may not be available immediately after posting — analytics update asynchronously- Force refresh has rate limits — don't spam it- Some metrics are platform-specific and may return null for platforms that don't support them

Frequently asked questions