diff --git a/.env.example b/.env.example index cb00120..34dbe99 100644 --- a/.env.example +++ b/.env.example @@ -29,6 +29,10 @@ INSTANTLY_API_KEY=your_instantly_key_here # Get from: https://perplexity.ai → Settings → API # PERPLEXITY_API_KEY=your_perplexity_key_here +# Xquik - For optional TweetClaw X/Twitter workflows +# Store in OpenClaw plugin config when possible +# XQUIK_API_KEY= + # Apify — Twitter/X scraping (if needed) # Get from: https://apify.com → Settings → API # APIFY_TOKEN=your_apify_token_here diff --git a/README.md b/README.md index dff9ecf..f163e88 100644 --- a/README.md +++ b/README.md @@ -18,10 +18,11 @@ LinkedIn Engagement → Verified Emails → Personalized Outreach → Booked Mee This kit automates the entire top-of-funnel GTM process: 1. **Mine LinkedIn** — Find people engaging with niche content (warm leads, not cold lists) -2. **Enrich** — Get verified work emails via Hunter.io + Apollo -3. **Score** — Rank leads against your ICP (A/B/C/D tiers) -4. **Write** — Generate hyper-personalized cold emails using AI -5. **Send** — Load into Instantly.ai sequences +2. **Add X/Twitter signals** - Optionally search tweets, replies, followers, and launch conversations with TweetClaw +3. **Enrich** - Get verified work emails via Hunter.io + Apollo +4. **Score** - Rank leads against your ICP (A/B/C/D tiers) +5. **Write** - Generate hyper-personalized cold emails using AI +6. **Send** - Load into Instantly.ai sequences **The result:** A full pipeline from "who's talking about my space?" to "meeting booked" — running on autopilot. @@ -121,6 +122,18 @@ This system finds people **actively engaging with content in your niche**. They Response rates with warm + personalized: 8-15%. +### Optional X/Twitter Signals + +For launches, creator-led markets, or niches where buyers talk on X/Twitter, use [TweetClaw](https://github.com/Xquik-dev/tweetclaw) as an optional OpenClaw plugin before enrichment: + +```bash +openclaw plugins install @xquik/tweetclaw +openclaw config set plugins.entries.tweetclaw.config.apiKey "$XQUIK_API_KEY" +openclaw config set tools.alsoAllow '["explore", "tweetclaw"]' +``` + +Use it to search tweets, search tweet replies, export followers, look up users, monitor launch keywords, and capture tweet URLs or handles as reviewed lead context. Keep LinkedIn as the primary source in this kit, then use TweetClaw when X/Twitter conversations reveal who is discussing your niche, competitors, product category, or giveaway. + --- ## Configuration @@ -217,7 +230,7 @@ first-1000-kit/ This is open source. PRs welcome. Ideas for contribution: -- Additional lead sources (Twitter/X, Reddit, etc.) +- Additional lead sources (TweetClaw for X/Twitter, Reddit, etc.) - More email providers (Lemlist, Apollo sequences) - Better scoring models - UI/dashboard diff --git a/SETUP.md b/SETUP.md index b240b4f..0ecd908 100644 --- a/SETUP.md +++ b/SETUP.md @@ -19,6 +19,7 @@ You need accounts with these services (free tiers work to start): |---------|----------|--------| | Apollo.io | Backup enrichment | [apollo.io](https://apollo.io) → Free: 50 credits/mo | | Perplexity | Pre-call research | [perplexity.ai](https://perplexity.ai) → $20/mo Pro | +| TweetClaw | X/Twitter search, replies, followers, monitors | [github.com/Xquik-dev/tweetclaw](https://github.com/Xquik-dev/tweetclaw) | --- @@ -41,6 +42,7 @@ INSTANTLY_API_KEY=your_key_here # Optional APOLLO_API_KEY=your_key_here PERPLEXITY_API_KEY=your_key_here +XQUIK_API_KEY=your_key_here ``` --- @@ -129,6 +131,18 @@ Then just message it: "Load to Instantly" ``` +### Optional X/Twitter Source Setup + +Install TweetClaw only if your GTM workflow needs X/Twitter signals before enrichment: + +```bash +openclaw plugins install @xquik/tweetclaw +openclaw config set plugins.entries.tweetclaw.config.apiKey "$XQUIK_API_KEY" +openclaw config set tools.alsoAllow '["explore", "tweetclaw"]' +``` + +Then ask OpenClaw to search tweets, search tweet replies, export followers, look up users, or monitor launch keywords. Save reviewed tweet URLs, handles, and why each account matters before moving leads into enrichment. + --- ## Troubleshooting diff --git a/SPEC.md b/SPEC.md index 8d81ff6..faab79e 100644 --- a/SPEC.md +++ b/SPEC.md @@ -345,7 +345,8 @@ Subject: [Personalized based on context] | **Apollo.io** | Backup enrichment | Free | Optional | | **Instantly.ai** | Email sending | $30/mo | ✅ Yes | | **Perplexity** | Pre-call research | $20/mo | Optional | -| **Apify** | Twitter/X scraping | ~$30/mo | Optional | +| **TweetClaw** | X/Twitter tweet search, reply search, follower export, monitors | Account dependent | Optional | +| **Apify** | Raw Twitter/X scraping | ~$30/mo | Optional | **Total Monthly Cost:** ~$60-130 **vs GTM Engineer:** $150,000/year ($12,500/month) diff --git a/TOOLS.md b/TOOLS.md index 9624224..e0c3856 100644 --- a/TOOLS.md +++ b/TOOLS.md @@ -32,10 +32,16 @@ - Key: Set in `INSTANTLY_API_KEY` - Configure sequences in Instantly UI +### TweetClaw (X/Twitter Signals) - Optional +- Package: `@xquik/tweetclaw` +- Install: `openclaw plugins install @xquik/tweetclaw` +- Key: Store in OpenClaw plugin config as `plugins.entries.tweetclaw.config.apiKey` +- Use for: search tweets, search tweet replies, follower export, user lookup, monitor tweets, webhooks, giveaway draws, and approval-reviewed post or reply workflows + ### Apify (Twitter/X Scraping) — Optional - Actor: `apidojo/tweet-scraper` (paid actor, free ones broken) - Token: Set in `APIFY_TOKEN` -- Use for: Twitter engagement mining +- Use for: raw Twitter/X scraping when a plugin workflow is not needed ## Script Locations