apidojo-io

apidojo-io/social-media-skills

Agent skills for scraping social media data at scale

2stars 1forks 1contributors

README.md

# Social Media Skills

Agent skills for scraping social media data at scale via [Apify](https://apify.com/apidojo?fpr=yhdrb). Battle-tested infrastructure used by tens of thousands of customers including enterprise teams. No login, no proxies — just data.

## Skills

| Skill | Platforms | What It Extracts |
| ----- | --------- | ---------------- |
| **x-scraper** | X (Twitter) | Tweets by search query, profile, hashtag, keyword, thread, date range, list |
| **instagram-scraper** | Instagram | Posts, reels, hashtags, locations, comments, profiles, followers |
| **tiktok-scraper** | TikTok | Videos, profiles, hashtags, music, comments, location-based posts |

## Installation

### npx skills (recommended)

Install all skills:

```bash
npx skills add apidojo-io/social-media-skills
```

Install a single skill:

```bash
npx skills add apidojo-io/social-media-skills --skill x-scraper
```

### Claude Code

```
/install-plugin https://github.com/apidojo-io/social-media-skills
```

### Cursor / Windsurf

Copy the `SKILL.md` from the skill you need into your project's `.cursor/skills/` or `.windsurf/skills/` directory.

### Codex / Gemini CLI

Reference the skill directly from the `skills/` directory or use `AGENTS.md` as context.

## Prerequisites

- **Apify paid plan** — [sign up](https://apify.com/?fpr=yhdrb) and [subscribe](https://apify.com/pricing?fpr=yhdrb)
- **APIFY_TOKEN** — get it from [console.apify.com/account/integrations](https://console.apify.com/account/integrations)
- **curl** or **wget** available in your environment

```bash
export APIFY_TOKEN="apify_api_xxxxxxxxxxxx"
```

## Contributing

1. Create a new folder under `skills/<skill-name>/`
2. Add a `SKILL.md` with YAML frontmatter (`name`, `description`) and instructions
3. Update this README and `.claude-plugin/marketplace.json`

## License

Apache-2.0