bmad-plus 0.1.0

package/osint-agent-package/skills/bmad-osint-investigate/osint/references/enrichment-databases-fr.md

@@ -0,0 +1,148 @@
+# Bases de données et outils d'enrichissement OSINT — France
+
+## 🇫🇷 Registres d'entreprises (données publiques, gratuites)
+
+### Pappers.fr ⭐ Priorité 1
+- **URL** : https://www.pappers.fr
+- **Données** : SIREN/SIRET, dirigeants (noms + adresses perso dans les statuts), bilans, statuts (PDF), actes, annonces BODACC
+- **Gratuit** : Oui (accès complet aux fiches, PDFs des statuts et actes)
+- **Astuce OSINT** : Les statuts de société contiennent souvent l'adresse personnelle du fondateur
+- **Google dork** : `"Nom Prénom" site:pappers.fr` ou `"Nom" filetype:pdf site:pappers.fr`
+
+### Societe.com
+- **URL** : https://www.societe.com
+- **Données** : Fiches entreprises, dirigeants, établissements, chiffre d'affaires
+- **Gratuit** : Données de base gratuites, détails payants
+- **Google dork** : `"Nom Prénom" site:societe.com dirigeant`
+
+### Infogreffe.fr
+- **URL** : https://www.infogreffe.fr
+- **Données** : Kbis, comptes annuels, actes officiels
+- **Gratuit** : Recherche gratuite, documents payants
+
+### Verif.com
+- **URL** : https://www.verif.com
+- **Données** : Fiches entreprises, dirigeants, données financières
+- **Gratuit** : Oui pour les infos de base
+
+### BODACC (Bulletin Officiel des Annonces Civiles et Commerciales)
+- **URL** : https://www.bodacc.fr
+- **Données** : Créations, modifications, radiations, ventes de fonds de commerce
+- **Gratuit** : Oui, source officielle
+
+### INPI (Institut National de la Propriété Industrielle)
+- **URL** : https://data.inpi.fr
+- **Données** : Marques déposées, brevets (contient le nom du déposant)
+- **Gratuit** : Oui
+
+### Datalegal.fr
+- **URL** : https://www.datalegal.fr
+- **Données** : Mandats sociaux d'un dirigeant (toutes ses sociétés)
+- **Gratuit** : Oui
+- **Astuce** : Tapez un nom pour voir TOUTES les sociétés où la personne est dirigeante
+
+---
+
+## 📞 Outils d'enrichissement de contacts
+
+### RocketReach ⭐ Priorité 1
+- **URL** : https://rocketreach.co
+- **Gratuit** : 5 lookups/mois
+- **Données** : Emails professionnels/perso, numéros de téléphone (portables !), profils sociaux
+- **Méthode** : Chercher le nom → voir les données partielles → utiliser un crédit gratuit pour révéler
+
+### ContactOut
+- **URL** : https://contactout.com
+- **Gratuit** : Extension Chrome, quelques crédits gratuits
+- **Données** : Emails et téléphones depuis les profils LinkedIn
+- **Méthode** : Installer l'extension → aller sur le profil LinkedIn → ContactOut affiche les données
+
+### Kaspr ⭐ Pour les portables FR
+- **URL** : https://www.kaspr.io
+- **Gratuit** : Extension Chrome + crédits gratuits à l'inscription
+- **Données** : Numéros de portable français directs, emails
+- **Méthode** : Extension Chrome sur LinkedIn → révèle le portable
+- **Avantage** : Spécialisé sur les données françaises
+
+### Lusha
+- **URL** : https://www.lusha.com
+- **Gratuit** : 5 crédits/mois
+- **Données** : Téléphones directs, emails
+
+### Apollo.io
+- **URL** : https://www.apollo.io
+- **Gratuit** : 50 crédits/mois
+- **Données** : Emails, téléphones, firmographics
+- **Avantage** : Filtrage avancé par industrie, taille d'entreprise, fonction
+
+### Hunter.io
+- **URL** : https://hunter.io
+- **Gratuit** : 25 recherches/mois
+- **Données** : Emails professionnels (pattern d'email de l'entreprise)
+
+---
+
+## 🔍 Google Dorks pour l'OSINT
+
+### Recherche de documents
+```
+"Nom Prénom" filetype:pdf                    # CV, rapports, statuts, bilans
+"Nom Prénom" filetype:pptx OR filetype:ppt   # Présentations
+"Nom Prénom" filetype:doc OR filetype:docx    # Documents Word
+"Nom Prénom" filetype:xls OR filetype:xlsx    # Tableurs
+```
+
+### Recherche de numéros de téléphone
+```
+"Nom Prénom" ("06" OR "07" OR "+33 6" OR "+33 7")   # Portables FR
+"Nom Prénom" (telephone OR mobile OR portable)        # Mentions de tel
+"Nom Prénom" (CV OR resume OR curriculum)              # CV avec coordonnées
+```
+
+### Recherche sur des sites spécifiques
+```
+"Nom" site:pappers.fr                         # Registre entreprises
+"Nom" site:societe.com                        # Registre entreprises
+"Nom" site:linkedin.com/in/                   # Profil LinkedIn
+"Nom" site:rocketreach.co                     # Enrichissement
+"Nom" site:contactout.com                     # Enrichissement
+```
+
+### Recherche de données perso dans des statuts/actes
+```
+"Nom Prénom" "demeurant" site:pappers.fr      # Adresse perso dans statuts
+"Nom Prénom" inurl:statuts filetype:pdf       # Statuts de société
+"Nom Prénom" "né(e) le"                       # Date de naissance
+```
+
+---
+
+## 📱 Réseaux sociaux et profils publics
+
+### LinkedIn
+- Profils professionnels, parcours, connexions
+- Avec Kaspr/ContactOut/Lusha → révèle les portables
+
+### Instagram
+- DM pour contact direct (surtout influenceurs)
+- Le bouton "Contact" affiche souvent l'email pro
+
+### Pages Jaunes / 118712
+- **URL** : https://www.pagesjaunes.fr / https://www.118712.fr
+- Pour les numéros de téléphone fixes et professionnels
+
+### YouTube
+- Les descriptions de vidéos contiennent parfois des emails de contact
+- Les chaînes business ont un onglet "À propos" avec contact
+
+---
+
+## Escalation recommandée (coût croissant)
+
+| Niveau | Sources | Coût |
+|--------|---------|------|
+| 1. Gratuit | Google dorks, Pappers, Societe.com, BODACC, INPI | 0€ |
+| 2. Freemium | RocketReach (5/mois), Kaspr (gratuit), Apollo (50/mois) | 0€ |
+| 3. Cheap | Jina search, Tavily search | ~$0.01 |
+| 4. Medium | Apify scrapers, ContactOut | ~$0.10 |
+| 5. Premium | Perplexity Deep, Exa Deep | ~$0.50 |

package/osint-agent-package/skills/bmad-osint-investigate/osint/references/platforms.md

@@ -0,0 +1,130 @@
+# Platform-Specific Extraction Guide
+
+## LinkedIn
+
+**Extract:** headline, positions (title, company, duration, description), education, summary, skills, location, pronouns, follower/connection count.
+
+**Finding profiles - URL patterns to try:**
+- /in/firstnamelastname
+- /in/firstname-lastname
+- /in/flastname
+- /in/lastname (if unique enough)
+
+**Search patterns:**
+- Brave: `site:linkedin.com "First Last" company`
+- Parallel: `"First Last" LinkedIn profile company city`
+
+**Key signals:**
+- Gaps between positions = career breaks
+- "Co-founder" vs "Founder" vs "Partner" = different ownership levels
+- Location changes between roles = relocation history
+- Short tenures (<1yr) = fired, bad fit, or stepping stone
+
+## Instagram
+
+**Extract:** bio, follower/following ratio, post count/frequency, captions, hashtags, engagement, highlights count.
+
+**Engagement rate:** (avg likes + comments) / followers * 100
+- >6% = close friends/niche, 3-6% = good, 1-3% = average, <1% = bots
+
+**Style signals:**
+- Minimal captions = private personality
+- Film photography hashtags = aesthetic sensibility
+- No selfies = introverted
+- High highlights count + low posts = active stories user
+
+## Facebook
+
+**Extract (via Bright Data only):** name, bio/intro, follower count, location, workplace, education, linked Instagram, website, recent public posts.
+
+**URL patterns:**
+- facebook.com/{username}
+- facebook.com/share/{id} (mobile share links - resolve to profile)
+- facebook.com/profile.php?id={numeric_id}
+
+## Telegram
+
+**Extract:** profile bio/title (t.me/{user}), channel posts (t.me/s/{channel}).
+
+**Writing analysis goldmine:**
+- Posts usually unedited = authentic voice
+- Posting times = timezone/work patterns
+- Emoji patterns = personality markers
+- Topic clusters = real vs performative interests
+- Forwarded from = what they read/follow
+
+## YouTube
+
+**Extract:** channel name, handle, subscriber count, video count, upload frequency, about/description, top videos by views, playlist structure.
+
+**Finding channels:**
+- Brave: `site:youtube.com "<Name>" channel`
+- Exa: `exa.sh search "<Name> youtube"`
+- Check LinkedIn/Instagram bios for YouTube links
+
+**Key signals:**
+- Upload frequency = discipline, commitment to topic
+- Subscriber/view ratio = audience quality
+- Comment engagement = community building skills
+- Video titles style = marketing/clickbait vs informative
+- Playlist structure = how they organize knowledge
+- Collaborations = social graph in their niche
+
+**Transcript extraction = HIGHEST PRIORITY.**
+See `references/content-extraction.md`. 3-5 transcripts minimum when channel found.
+
+## Podcasts / Audio
+
+**Finding appearances:**
+- Brave: `"<Name>" podcast interview guest`
+- Exa: `exa.sh search "<Name> podcast episode"`
+
+**Key signals:**
+- Personal questions from host → origin story, failures, mentors
+- Cross-reference claims in podcast vs LinkedIn (people exaggerate on podcasts too, but differently)
+- Guest on niche podcasts = real expertise; guest on general podcasts = self-promotion
+
+## TikTok
+
+**Extract:** username, bio, follower/following count, total likes, video count, top videos by views, hashtags used, engagement rate.
+
+**Finding accounts:**
+- Brave: `site:tiktok.com "@username" OR "Name"`
+- Apify: `clockworks/tiktok-user-search-scraper` with keywords
+- Check Instagram/YouTube bios for TikTok links
+
+**URL patterns:**
+- tiktok.com/@username
+- tiktok.com/@username/video/{id}
+
+**Key signals:**
+- Short-form video = unfiltered personality (harder to fake than LinkedIn)
+- Duets/stitches = who they interact with (social graph)
+- Sound choices = cultural references, generation markers
+- Comment replies = engagement style, how they handle criticism
+- Posting frequency = discipline, content strategy vs impulse
+
+**Style analysis:**
+- Face-to-camera = confident, extroverted
+- Voiceover only = introverted or analytical
+- Trending sounds = follower mentality
+- Original audio = thought leader / creator
+- High production = professional content, possible team
+
+## Google Maps / Business Listings
+
+**Extract:** business name, address, phone, website, hours, reviews, rating, owner responses.
+
+**OSINT value:**
+- Owner responses to reviews = writing style, conflict resolution patterns
+- Business address = physical location confirmation
+- Multiple businesses at same address = related entities
+- Review timeline = business lifecycle
+
+## Industry Sources (Russian market)
+- AdIndex.ru - ad industry news, appointments, interviews
+- Sostav.ru - marketing industry portal
+- GlobMSK.ru - Moscow business directory with bios
+- Kommersant.ru - business newspaper, rankings
+- Forbes.ru - profiles, lists
+- ConferenceCast.tv - speaker profiles with video

package/osint-agent-package/skills/bmad-osint-investigate/osint/references/psychoprofile.md

@@ -0,0 +1,69 @@
+# Psychoprofile Construction
+
+## Core Principle
+Deduce from BEHAVIOR, never assume. Every trait needs cited evidence.
+
+## MBTI Assessment
+
+### E vs I (Extraversion / Introversion)
+E markers: high posting frequency, "we/let's/together", conferences, large audience
+I markers: low posting, "I noticed/I tried", few appearances, small engaged audience
+
+### S vs N (Sensing / Intuition)
+S markers: concrete examples, numbers, step-by-step, linear career, photos of things
+N markers: cross-domain connections, trend predictions, metaphors, career pivots
+
+### T vs F (Thinking / Feeling)
+T markers: "metrics/ROI/optimization", impersonal analysis, low emoji
+F markers: "I understand/that's hard", vulnerability, warm emoji (❤️ 🤗 ✨)
+
+### J vs P (Judging / Perceiving)
+J markers: regular schedule, structured content, long tenures, goals
+P markers: irregular posting, spontaneous content, frequent changes, process-oriented
+
+### Confidence Levels
+- High: 10+ data points across 3+ sources
+- Medium: 5-10 data points across 2+ sources
+- Low: <5 data points or single source
+
+## Big Five Alternative (OCEAN)
+- Openness: career diversity, travel, arts, experimental content
+- Conscientiousness: posting regularity, career progression, structured writing
+- Extraversion: social media activity, public speaking, collaboration
+- Agreeableness: language warmth, conflict avoidance, community focus
+- Neuroticism: hedging, anxiety markers, perfectionism
+
+## Source Priority for Psychoprofile
+
+Ranked by signal quality (best → worst):
+1. **YouTube transcripts / podcast interviews** — unscripted, long-form, authentic voice
+2. **Telegram messages** — unfiltered daily communication
+3. **Blog posts / articles** — edited but personal voice
+4. **Instagram captions** — curated but with personality leaks
+5. **LinkedIn posts** — performative, lowest signal-to-noise
+6. **Conference talks** — scripted but body language cues in descriptions
+
+If YouTube channel exists with 5+ videos — it is the PRIMARY psychoprofile source.
+Extract 3-5 transcripts before attempting MBTI assessment.
+
+## Writing Style Quantification
+- Average sentence length (short <10, medium 10-20, long 20+)
+- Emoji density (per 100 words)
+- Self-reference rate (I/me per 100 words)
+- Hedge word frequency (maybe, perhaps, possibly)
+- Language switching patterns (bilingual profiles)
+- What they DON'T write about = privacy boundaries
+
+## Values Deduction (from actions, not words)
+- What they create → what they value
+- What they share/forward → community identity
+- Career trajectory → money vs impact vs status vs freedom
+- Platform choices → privacy tolerance, tech savviness
+- What they avoid → boundaries
+
+## Personal Data Rules
+- Zodiac: ONLY if birth date CONFIRMED (never guess)
+- Family: only CONFIRMED info (photos, bios mentioning kids)
+- Pets: usually visible in Instagram stories
+- Relationship: only if explicitly stated
+- Never speculate on family structure

package/osint-agent-package/skills/bmad-osint-investigate/osint/references/tools.md

@@ -0,0 +1,281 @@
+# OSINT Toolkit Reference
+
+## Table of Contents
+1. [Search Tools](#search-tools)
+2. [Scraping Tools](#scraping-tools)
+3. [Apify Actor Runner](#apify-actor-runner-embedded)
+4. [Apify Actor Catalog (55+)](#apify-actor-catalog)
+5. [Actor Discovery](#actor-discovery)
+6. [Shortcuts (apify.sh)](#shortcuts)
+7. [Telegram](#telegram)
+8. [Apify Troubleshooting](#apify-troubleshooting)
+9. [Cost Reference](#cost-reference)
+
+---
+
+## Search Tools
+
+### Brave Search (web_search built-in)
+- No setup, FREE plan 2000 queries/month, rate limit 1/sec
+- Best for: general web, articles, profile discovery
+- Weakness: rate limited, no geo-targeting
+
+### Jina s.reader (scripts/jina.sh search)
+- Top 10 results as full markdown
+- Best for: broad search with content extraction
+- Weakness: can return wrong person on common names
+
+### Parallel AI (scripts/parallel.sh search)
+- AI-powered search with reasoning and citations
+- Best for: social media discovery, cross-referencing
+- Weakness: sometimes returns irrelevant AI-reasoned results
+
+### Bright Data (scripts/brightdata.sh search)
+- Google/Bing/Yandex with geo-targeting, bypasses CAPTCHA
+- search-geo: `brightdata.sh search-geo ru "query"` (search as if from Russia)
+- search-yandex: `brightdata.sh search-yandex "query"` (better for Russian targets)
+- Batch: up to 10 queries
+
+## Scraping Tools
+
+### web_fetch (built-in)
+- Basic URL → markdown. First attempt, fallback to better tools
+- Fails on: LinkedIn, Facebook, Cloudflare
+
+### Jina r.reader (scripts/jina.sh read)
+- Clean markdown, faster than web_fetch
+- Fails on: LinkedIn authwall, Facebook authwall, Instagram JS
+
+### Bright Data (scripts/brightdata.sh scrape)
+- **Bypasses EVERYTHING**: bot detection, CAPTCHA, authwall, Cloudflare
+- The nuclear option. Use when others fail.
+- Batch: up to 10 URLs via scrape-batch
+
+---
+
+## Apify Actor Runner (embedded)
+
+`run_actor.js` — universal script that runs ANY Apify actor. Embedded from
+[apify/agent-skills](https://github.com/apify/agent-skills) v1.3.0.
+
+**Requirements:** Node.js 18+ (for global fetch), APIFY_API_TOKEN or APIFY_TOKEN env var.
+
+### Via bash wrapper (recommended)
+
+```bash
+# Quick answer — top 5 results in chat
+bash scripts/run-actor.sh "ACTOR_ID" 'JSON_INPUT'
+
+# Export to CSV
+bash scripts/run-actor.sh "ACTOR_ID" 'JSON_INPUT' --output /tmp/result.csv --format csv
+
+# Export to JSON
+bash scripts/run-actor.sh "ACTOR_ID" 'JSON_INPUT' --output /tmp/result.json --format json
+```
+
+### Direct node call
+
+```bash
+APIFY_TOKEN=$APIFY_API_TOKEN node scripts/run_actor.js \
+  --actor "ACTOR_ID" --input 'JSON_INPUT'
+```
+
+---
+
+## Apify Actor Catalog
+
+### Instagram (12 actors)
+
+| Actor ID | Best For | OSINT Use |
+|----------|----------|-----------|
+| `apify/instagram-profile-scraper` | Profile data, follower counts, bio | **Primary** — bio, location, links |
+| `apify/instagram-post-scraper` | Individual post details, engagement | Content analysis |
+| `apify/instagram-comment-scraper` | Comment extraction | Sentiment, social graph |
+| `apify/instagram-hashtag-scraper` | Hashtag content, trending topics | Find target by hashtag |
+| `apify/instagram-hashtag-stats` | Hashtag performance metrics | Audience analysis |
+| `apify/instagram-reel-scraper` | Reels content and metrics | Video content style |
+| `apify/instagram-search-scraper` | Search users, places, hashtags | Discovery |
+| `apify/instagram-tagged-scraper` | Posts tagged with specific accounts | **Who tags them** = social graph |
+| `apify/instagram-followers-count-scraper` | Follower count tracking | Influence assessment |
+| `apify/instagram-scraper` | Comprehensive Instagram data | Full profile deep dive |
+| `apify/instagram-api-scraper` | API-based Instagram access | Fallback scraper |
+| `apify/export-instagram-comments-posts` | Bulk comment/post export | Large-scale extraction |
+
+### Facebook (14 actors)
+
+| Actor ID | Best For | OSINT Use |
+|----------|----------|-----------|
+| `apify/facebook-pages-scraper` | Page data, metrics, contact info | **Primary** for public pages |
+| `apify/facebook-page-contact-information` | Emails, phones, addresses | Contact enrichment |
+| `apify/facebook-posts-scraper` | Post content and engagement | Writing style analysis |
+| `apify/facebook-comments-scraper` | Comment extraction | Sentiment analysis |
+| `apify/facebook-likes-scraper` | Reaction analysis | Audience mapping |
+| `apify/facebook-reviews-scraper` | Page reviews | Reputation analysis |
+| `apify/facebook-groups-scraper` | Group content and members | Community membership |
+| `apify/facebook-events-scraper` | Event data | Activity/interests |
+| `apify/facebook-ads-scraper` | Ad creative and targeting | Competitor intel |
+| `apify/facebook-search-scraper` | Search results | Discovery |
+| `apify/facebook-reels-scraper` | Reels content | Video style |
+| `apify/facebook-photos-scraper` | Photo extraction | Visual profile |
+| `apify/facebook-marketplace-scraper` | Marketplace listings | Business activity |
+| `apify/facebook-followers-following-scraper` | Follower/following lists | Social graph |
+
+**Note:** Facebook personal profiles require Bright Data. These actors work with public Pages/Groups/Marketplace.
+
+### TikTok (14 actors)
+
+| Actor ID | Best For | OSINT Use |
+|----------|----------|-----------|
+| `clockworks/tiktok-scraper` | Comprehensive TikTok data | Full platform deep dive |
+| `clockworks/free-tiktok-scraper` | Free TikTok extraction | **Budget fallback** |
+| `clockworks/tiktok-profile-scraper` | Profile data, bio, stats | **Primary** — bio, follower data |
+| `clockworks/tiktok-video-scraper` | Video details and metrics | Content analysis |
+| `clockworks/tiktok-comments-scraper` | Comment extraction | Sentiment, audience |
+| `clockworks/tiktok-followers-scraper` | Follower lists | Social graph |
+| `clockworks/tiktok-user-search-scraper` | Find users by keywords | **Discovery** by name |
+| `clockworks/tiktok-hashtag-scraper` | Hashtag content | Topic analysis |
+| `clockworks/tiktok-sound-scraper` | Trending sounds | Cultural markers |
+| `clockworks/tiktok-ads-scraper` | Ad content | Competitor ads |
+| `clockworks/tiktok-discover-scraper` | Discover page content | Trending content |
+| `clockworks/tiktok-explore-scraper` | Explore content | Algorithm analysis |
+| `clockworks/tiktok-trends-scraper` | Trending content | Trend tracking |
+| `clockworks/tiktok-live-scraper` | Live stream data | Real-time activity |
+
+### YouTube (5 actors)
+
+| Actor ID | Best For | OSINT Use |
+|----------|----------|-----------|
+| `streamers/youtube-scraper` | Video data and metrics | Content analysis |
+| `streamers/youtube-channel-scraper` | Channel info, subscriber data | **Primary** — channel metadata |
+| `streamers/youtube-comments-scraper` | Comment extraction | Audience sentiment |
+| `streamers/youtube-shorts-scraper` | Shorts content | Short-form style |
+| `streamers/youtube-video-scraper-by-hashtag` | Videos by hashtag | Topic discovery |
+
+### Google Maps (4 actors)
+
+| Actor ID | Best For | OSINT Use |
+|----------|----------|-----------|
+| `compass/crawler-google-places` | Business listings, ratings, contact | **Primary** — verify business owners |
+| `compass/google-maps-extractor` | Detailed business data | Deep business intel |
+| `compass/Google-Maps-Reviews-Scraper` | Review extraction | Writing style in responses |
+| `poidata/google-maps-email-extractor` | Email discovery from listings | Contact enrichment |
+
+### Other Platforms (6 actors)
+
+| Actor ID | Best For | OSINT Use |
+|----------|----------|-----------|
+| `apify/google-search-scraper` | Google search results | Structured search |
+| `apify/google-trends-scraper` | Google Trends data | Interest tracking |
+| `voyager/booking-scraper` | Booking.com hotel data | Travel/business intel |
+| `voyager/booking-reviews-scraper` | Booking.com reviews | Reputation |
+| `maxcopell/tripadvisor-reviews` | TripAdvisor reviews | Hospitality intel |
+| `vdrmota/contact-info-scraper` | Contact enrichment from URLs | **Emails/phones from any site** |
+
+### LinkedIn
+
+LinkedIn actors are volatile on Apify. Current primary:
+- `supreme_coder~linkedin-profile-scraper` via `apify.sh linkedin` → $0.005/profile
+- Fallback: `brightdata.sh scrape` (always works, higher cost)
+- If primary fails: `bash scripts/apify.sh store-search "linkedin scraper"`
+
+---
+
+## Actor Selection by OSINT Task
+
+| OSINT Phase | What You Need | Primary Actors |
+|-------------|---------------|----------------|
+| **Profile discovery** | Find accounts | `apify/instagram-search-scraper`, `clockworks/tiktok-user-search-scraper`, `apify/facebook-search-scraper` |
+| **Profile deep dive** | Extract bio/stats | `apify/instagram-profile-scraper`, `clockworks/tiktok-profile-scraper`, `streamers/youtube-channel-scraper` |
+| **Social graph** | Who they interact with | `apify/instagram-tagged-scraper`, `apify/instagram-comment-scraper`, `clockworks/tiktok-followers-scraper`, `apify/facebook-followers-following-scraper` |
+| **Content analysis** | Posts, videos, style | `apify/instagram-post-scraper`, `clockworks/tiktok-video-scraper`, `streamers/youtube-scraper` |
+| **Contact enrichment** | Emails, phones | `vdrmota/contact-info-scraper`, `apify/facebook-page-contact-information`, `poidata/google-maps-email-extractor` |
+| **Business verification** | Company, location | `compass/crawler-google-places`, `compass/google-maps-extractor` |
+| **Psychoprofile signals** | Sentiment, style | `apify/instagram-comment-scraper`, `clockworks/tiktok-comments-scraper`, `streamers/youtube-comments-scraper` |
+
+### Multi-Actor Workflows (OSINT-specific)
+
+| Workflow | Step 1 → | Step 2 |
+|----------|----------|--------|
+| **Full Instagram** | `apify/instagram-profile-scraper` → | `apify/instagram-tagged-scraper` + `apify/instagram-comment-scraper` |
+| **Business owner** | `compass/crawler-google-places` → | `vdrmota/contact-info-scraper` on website |
+| **Content creator** | `streamers/youtube-channel-scraper` → | `streamers/youtube-comments-scraper` |
+| **TikTok target** | `clockworks/tiktok-user-search-scraper` → | `clockworks/tiktok-profile-scraper` + `clockworks/tiktok-comments-scraper` |
+| **Facebook page** | `apify/facebook-pages-scraper` → | `apify/facebook-posts-scraper` + `apify/facebook-page-contact-information` |
+
+---
+
+## Actor Discovery
+
+When none of the 55+ actors fit, search the Apify Store dynamically:
+
+```bash
+# Via mcpc CLI (if installed)
+APIFY_TOKEN=$APIFY_API_TOKEN mcpc --json mcp.apify.com \
+  --header "Authorization: Bearer $APIFY_TOKEN" \
+  tools-call search-actors keywords:="SEARCH_KEYWORDS" limit:=10
+
+# Via Apify API directly
+bash scripts/apify.sh store-search "keyword1 keyword2"
+```
+
+Tips:
+- Use 1-3 simple keywords (e.g., "LinkedIn profiles", "Twitter scraper")
+- Sort by: PAY_PER_EVENT (works with small budgets), high rating, high run count
+- Actors on Apify are volatile — always have a Bright Data fallback
+
+---
+
+## Shortcuts
+
+`apify.sh` provides quick shortcuts for common operations:
+
+```bash
+bash scripts/apify.sh linkedin "https://linkedin.com/in/..."  # $0.005
+bash scripts/apify.sh instagram "handle"                       # free tier
+bash scripts/apify.sh run <actor_id> '<json>'                  # any actor
+bash scripts/apify.sh results <run_id>                         # get results
+bash scripts/apify.sh run-status <run_id>                      # check status
+bash scripts/apify.sh store-search "query"                     # find actors
+```
+
+For anything beyond shortcuts, use `run-actor.sh` — it handles polling,
+timeout, and CSV/JSON export automatically.
+
+---
+
+## Telegram
+
+- Public channel posts: `web_fetch https://t.me/s/{channel}` (free, last ~20 posts)
+- Profile bio: `web_fetch https://t.me/{username}` (free, shows bio/title)
+- Private messages: tg.py (Telegram skill) or mcporter telegram tools
+
+---
+
+## Apify Troubleshooting
+
+When an Apify actor fails:
+1. Check if it blocks API on free plan ("run through UI only" error)
+2. Check input field names (profileUrls vs urls vs user_name — varies per actor)
+3. Check run status: `bash scripts/apify.sh run-status <run_id>`
+4. Search for alternatives: `bash scripts/apify.sh store-search "platform scraper"`
+5. Try the free-tier variant (e.g., `clockworks/free-tiktok-scraper`)
+6. Fall back to Bright Data: `bash scripts/brightdata.sh scrape "<url>"`
+
+---
+
+## Cost Reference
+
+| Tool | Cost | Notes |
+|------|------|-------|
+| LinkedIn (Apify supreme_coder) | $0.005/profile | |
+| Instagram (Apify) | free tier | Limited runs |
+| TikTok (Apify clockworks) | $0.01-0.05/profile | free-tiktok-scraper = free |
+| YouTube (Apify streamers) | $0.01/channel | |
+| Google Maps (Apify compass) | $0.01/listing | |
+| Contact enrichment | $0.01/URL | |
+| Facebook pages (Apify) | $0.01/page | Personal profiles = Bright Data |
+| Facebook personal (Bright Data) | per-request | Check account balance |
+| Jina | free tier with key | |
+| Parallel | free tier with key | |
+| Brave | free (2000/month) | |
+| **Budget rule** | **≤$0.50 without asking** | **>$0.50 ask user** |