athina-ai/twitter-scraper
skills/capabilities/twitter-scraper/SKILL.md
Search and scrape Twitter/X posts using Apify. Use when you need to find tweets, track brand mentions, monitor competitors on Twitter, or analyze Twitter discussions. Uses Twitter native search syntax (since:/until:) for reliable date filtering.
$ install --global
skillsauthnpx skillsauth add athina-ai/goose-skills twitter-scraperInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 3, 2026, 10:04 AM23.1s3 files scanned
SKILL.md
- name:
- twitter-scraper
- description:
- >
- Uses Twitter native search syntax (since:
- /until:) for reliable date filtering.
Twitter Scraper
Search Twitter/X posts using the Apify apidojo/tweet-scraper actor.
Quick Start
Requires APIFY_API_TOKEN env var (or --token flag). Install dependency: pip install requests.
# Search with date range (recommended — uses Twitter native since:/until: operators)
python3 skills/twitter-scraper/scripts/search_twitter.py \
--query "YourCompany" --since 2026-02-15 --until 2026-02-23
# Quick summary of recent mentions
python3 skills/twitter-scraper/scripts/search_twitter.py \
--query "@yourhandle" --max-tweets 20 --output summary
# Search without date filtering
python3 skills/twitter-scraper/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
- Builds a search term with the query quoted and date operators appended
- Calls the Apify
apidojo/tweet-scraperactor via REST API - Polls until the run completes, then fetches the dataset
- Deduplicates by tweet ID/URL
- Applies optional keyword filtering (client-side)
- Sorts by likes (descending) and outputs JSON or summary
CLI Reference
| Flag | Default | Description |
|------|---------|-------------|
| --query | required | Search query (quoted in Twitter search) |
| --since | none | Start date YYYY-MM-DD (inclusive) |
| --until | none | End date YYYY-MM-DD (exclusive) |
| --max-tweets | 50 | Max tweets to scrape |
| --keywords | none | Additional filter keywords (comma-separated, OR logic) |
| --output | json | Output format: json or summary |
| --token | env var | Apify token (prefer APIFY_API_TOKEN env var) |
| --timeout | 300 | Max seconds to wait for the Apify run |
Direct API Usage
{
"searchTerms": ["\"YourCompany\" since:2026-02-15 until:2026-02-22"],
"maxTweets": 50,
"searchMode": "live"
}
Output Format
Tweets are returned as JSON array sorted by likes. Each tweet has:
{
"id": "...",
"text": "Tweet text...",
"fullText": "Full tweet text...",
"likeCount": 42,
"retweetCount": 5,
"replyCount": 3,
"viewCount": 1200,
"createdAt": "2026-02-18T12:00:00.000Z",
"author": {"userName": "handle", "name": "Display Name", ...},
"twitterUrl": "https://twitter.com/..."
}
Common Workflows
Competitor Monitoring
python3 skills/twitter-scraper/scripts/search_twitter.py \
--query "CompetitorName" --since 2026-02-15 --until 2026-02-23 --output summary
Brand Mention Tracking
python3 skills/twitter-scraper/scripts/search_twitter.py \
--query "@YourHandle OR \"YourBrand\"" --max-tweets 100
Related Skills
athina-ai/video-polish
content-media
VerifiedTrustedCommunity
Takes an existing screen recording or demo video and adds professional zoom/pan effects synchronized to the narration. Uses transcript-driven zoom targeting and Remotion for rendering. Optionally replaces audio with a soundtrack.
507SKILL.mdUpdated Apr 25, 2026
athina-ai/video-clipper
tools
VerifiedTrustedCommunity
Repurposes long-form video (podcasts, interviews, talks) into short-form vertical clips for Instagram Reels, TikTok, and YouTube Shorts. Handles transcription, moment selection, clip extraction, speaker-tracked reframing (16:9 to 9:16), and animated captions.
507SKILL.mdUpdated Apr 25, 2026
athina-ai/talking-head-video
development
VerifiedTrustedCommunity
Creates talking head videos from any source material (docs, changelogs, blog posts, notes, transcripts). Produces multi-scene videos with avatar narration over screenshots/images using HeyGen v2 API. Supports Quick Shot and Full Producer modes.
507SKILL.mdUpdated Apr 25, 2026
athina-ai/product-reel-generator
tools
VerifiedTrustedCommunity
Generates Instagram-ready product reels from any e-commerce product page URL. Scrapes product images, classifies by type, generates AI-animated clips via Higgsfield API, creates text overlays with style presets, and composes a 15-20 second reel with music. Supports model-based and product-only reels.
507SKILL.mdUpdated Apr 25, 2026