docs: add optional TweetClaw source

.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=<your_xquik_key_here>
+
 # Apify — Twitter/X scraping (if needed)
 # Get from: https://apify.com → Settings → API
 # APIFY_TOKEN=your_apify_token_here

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

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

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)

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