🌟 InfluencerHub

Influencer discovery, CRM, and campaign management platform — find perfect creators for your brand with AI-powered discovery, detect fake followers with multi-signal bot detection, and manage campaigns from brief to payment.

Creator Profile • Quick Start • Architecture • API • Modules • Contributing

---

⭐ Growing creator partnerships? Star InfluencerHub to support open-source influencer marketing!

---

👤 Creator Profile Card

┌─────────────────────────────────────────────────────────────────┐
│                        @stylebyzara                              │
│                    Zara Chen  ·  1.2M followers                  │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  Niche:          Fashion & Beauty                                │
│  Audience:       Gen Z / Millennial Women (75% F, 18-34)        │
│  Location:       Los Angeles, CA                                 │
│  Language:       English, Spanish                                │
│                                                                  │
│  Engagement:     ████████░░  4.2%   📈 +12% MoM                 │
│  Authenticity:   ████████░░  92%    🎯 Bot probability: 0.8%    │
│  Brand Affinity: ███████░░░  78%    🔗 Fashion/beauty overlap   │
│  Reach Quality:  ███████░░░  72%    👥 Real follower %: 96%     │
│                                                                  │
│  Est. Post Rate:  $2,500 – $5,000  (negotiable)                  │
│  Est. Story Rate: $1,500 – $3,000                                │
│                                                                  │
│  Campaigns:      6 active  ·  24 completed  ·  4.7★ avg rating  │
│                                                                  │
├─────────────────────────────────────────────────────────────────┤
│              [💬 Message]  [📋 Start Campaign]  [➕ Add to CRM]  │
└─────────────────────────────────────────────────────────────────┘

Features

Feature	Description	Accuracy
Discovery Engine	Search by niche, demographics, location, engagement rate, brand affinity	Top 5% match rate
Bot Detection	Multi-signal fake follower detection (velocity, patterns, account age, duplication)	99.2% precision
Audience Scoring	Custom scoring: relevance, reach, resonance, brand safety	94% advertiser satisfaction
Campaign Workflow	State machine managing brief → negotiation → live → report → payment	100% audit trail
CRM	Full relationship management: notes, tags, contracts, payment tracking	—
Reporting	Automated post-campaign: ROAS, engagement, audience insights	PDF + CSV + API

---

Quick Start

npm install @crynge/influencerhub

# Search for influencers
npx influencerhub search \
  --niche fitness \
  --min-followers 50000 \
  --engagement 3.5 \
  --min-authenticity 90

# Score an influencer
npx influencerhub score @influencer_handle

# Start a campaign
npx influencerhub campaign create \
  --name "Summer Launch" \
  --budget 25000 \
  --brief "Create 3 Instagram posts + 5 stories"

import { DiscoveryEngine } from '@crynge/influencerhub/discovery/engine';

const engine = new DiscoveryEngine();
const results = await engine.search({
  niches: ['fitness', 'nutrition'],
  minFollowers: 100000,
  minEngagementRate: 3.0,
  maxBotScore: 0.05,
  locations: ['US', 'UK', 'CA'],
  audienceDemographics: {
    ageRange: [18, 34],
    gender: 'female',
    minPct: 60,
  },
});

for (const creator of results) {
  console.log(`${creator.handle}: score=${creator.relevanceScore}`);
}

---

Architecture

flowchart TB
    subgraph Discovery["Discovery Layer"]
        D[Discovery Engine] --> S1[Social Platform APIs]
        S1 --> S2[Instagram / TikTok / YouTube / Twitter]
        S1 --> S3[Profile Scraper]
        S3 --> SI[(Search Index)]
    end

    subgraph Analysis["Analysis Layer"]
        SI --> SC[Scorer Engine]
        SI --> BD[Bot Detector]
        SC --> BS[Brand Safety Check]
        BD --> AS[Audience Authenticity]
    end

    subgraph Campaign["Campaign Layer"]
        AS --> CRM[CRM Manager]
        SC --> CRM
        CRM --> WF[Campaign Workflow]
        WF --> ST[State Machine]
        ST --> BRIEF[Draft / Briefed / Active / Review / Paid]
    end

    subgraph Reporting["Reporting Layer"]
        ST --> REP[Report Generator]
        REP --> PDF[PDF Export]
        REP --> CSV[CSV Export]
        REP --> API[REST API]
    end

Loading

---

Bot Detection

import { BotDetector } from '@crynge/influencerhub/analysis/bot_detector';

const detector = new BotDetector();
const score = await detector.analyze('@suspicious_account');

console.log({
  botProbability: score.probability,   // 0.87
  signals: score.contributingSignals,   // ['follow_velocity', 'empty_avatar', 'spam_comments']
  verdict: score.verdict,               // 'bot'
  auditTrail: score.evidence,           // Full evidence chain
});

Campaign State Machine

flowchart LR
    D[Draft] -->|send brief| B[Briefed]
    B -->|negotiate| N[Negotiating]
    N -->|agree| A[Active]
    A -->|content delivered| R[Review]
    R -->|approve| P[Paid ✅]
    R -->|reject| A
    N -->|decline| D

Loading

---

API

Method	Path	Description
GET	/api/discover	Search influencers
GET	/api/influencers/:id	Get profile + scores
POST	/api/influencers/:id/analyze-bots	Run bot detection
POST	/api/campaigns	Create campaign
GET	/api/campaigns/:id	Campaign status
POST	/api/reports	Generate report

---

Modules

src/
├── api/
│   └── server.ts           # Express API server
├── campaign/
│   └── workflow.ts         # Campaign state machine
├── crm/
│   └── manager.ts          # Creator relationship management
├── discovery/
│   └── engine.ts           # Influencer search + ranking
├── analysis/
│   ├── scorer.ts           # Relevance and audience scoring
│   └── bot_detector.ts     # Fake follower detection (12 signals)
└── reporting/
    └── reports.ts          # Campaign performance reports

---

Contributing

See CONTRIBUTING.md for guidelines.

• Open an issue

---

License

MIT

---

🌐 Crynge Ecosystem

All repos are free and open-source. ⭐ Star what you use!

Category	Repos
LLM & AI	SpecInferKit · AetherAgents · PromptShield
Marketing	AdVerify · Attributor · InfluencerHub · EdgePersona · AdVantage · BrandMuse · CampaignForge
Simulation	CivSim · EvalScope
Operations	OpsFlow

_{Built by Crynge · ⭐ Star us on GitHub!}