twitter-mention-trackerlisted
Install: claude install-skill gooseworks-ai/goose-skills
# Twitter Mention Tracker
Search Twitter/X posts using the Apify `apidojo/tweet-scraper` actor.
## Quick Start
Requires `APIFY_API_TOKEN` env var (or `--token` flag).
```bash
# Search with date range (recommended -- uses Twitter native since:/until: operators)
python3 skills/twitter-mention-tracker/scripts/search_twitter.py \
--query "YourCompany" --since 2026-02-15 --until 2026-02-23
# Quick summary of recent mentions
python3 skills/twitter-mention-tracker/scripts/search_twitter.py \
--query "@yourhandle" --max-tweets 20 --output summary
# Search without date filtering
python3 skills/twitter-mention-tracker/scripts/search_twitter.py \
--query "AI content marketing" --max-tweets 50
```
## Date Filtering
**Important:** The `apidojo/tweet-scraper` actor's built-in date parameters are unreliable.
This script embeds `since:YYYY-MM-DD` and `until:YYYY-MM-DD` directly into the search query
string, using Twitter's native advanced search syntax. This ensures date filtering works
correctly server-side.
## How the Script Works
1. Builds a search term with the query quoted and date operators appended
2. Calls the Apify `apidojo/tweet-scraper` actor via REST API
3. Polls until the run completes, then fetches the dataset
4. Deduplicates by tweet ID/URL
5. Applies optional keyword filtering (client-side)
6. Sorts by likes (descending) and outputs JSON or summary
## CLI Reference
| Flag | Default | Description |
|------|---------|-------------|
| `--query` | *required* | S