MAHMOUD ABDELNABY
Social · CLI SCRIPT · 2

Influencer Fake Engagement & Engagement Pod Detection Script

Expose fake influencer engagement and private comment pods. Audit exported social comments for bot entropy and repetitive spam.

Problem it addresses

Develop a pure Python influencer audit utility (pod_detector.py): 1) Ingests exported comment CSVs (Author, Text, Timestamp), 2) Calculates Lexical Diversity (Shannon Entropy) to spot repetitive canned phrases, 3) Detects comment timing bursts (50 comments in 2 minutes = pod coordination), 4) Outputs an authenticity score (0-100) and visual HTML diagnostic report.

Who it is for

PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

What is inside

Key files listed in the README repository architecture:

  • checklists/deliverable-qa-checklist.md
  • contracts/influencer-usage-rights-addendum.md
  • examples/fake_comments_sample.csv
  • examples/perfume-brand-brief-case.md
  • LICENSE
  • README.md
  • reports/authenticity_audit_sample.html
  • rubrics/influencer-vetting-scorecard.md
  • src/pod_detector.py
  • templates/creator-creative-brief.md
  • tests/test_detector.py
  • tests/test_pod_detector.py

How to evaluate and use it

  1. Read the README first and confirm that the documented problem matches your use case.
  2. Inspect the listed files to find the data, tools, templates, and tests relevant to your task.
  3. Follow the repository’s Quick Start and check prerequisites before running commands.
  4. Compare outputs with documented examples and review limitations before using them in a decision or client workflow.

Quick Start from the README: python -m unittest discover -s tests · python src/pod_detector.py --help

Scope and limitations

  • Engagement Pod Detection: Flags repetitive, generic comments ('روعة', 'ما شاء الله', emoji strings) posted within minutes of publishing.
  • Follower Spike Telemetry: Identifies unnatural overnight follower increases inconsistent with typical organic discovery curves.
  • Audience Geography Audit: Measures percentage of followers located outside the target GCC/MENA market.

This page summarizes the available documentation; it does not establish performance or business results. Verify data and prerequisites before use.

Related repositories