MCPInstall

whatsapp-mass-sender-group-marketing

Automate WhatsApp mass messaging, group marketing, and TikTok/Instagram follower extraction for targeted outreach campaigns

Installs
796
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/reason-machines/marketing-skills --skill whatsapp-mass-sender-group-marketing
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads whatsapp-mass-sender-group-marketing automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

WhatsApp Mass Sender & Group Marketing System

Skill by ara.so — Marketing Skills collection.

Overview

This project provides automated tools for multi-platform social media marketing, focusing on:

  • WhatsApp bulk messaging and group marketing campaigns
  • TikTok & Instagram follower extraction from competitor accounts
  • Automated engagement (likes, comments, follows, DMs)
  • Lead filtering by demographics, activity, and AI-based criteria
  • Cross-platform automation for social media growth

Primary use cases:

  • E-commerce stores running targeted outreach
  • Marketing agencies managing multiple client accounts
  • MCN organizations building follower bases
  • Affiliate marketers finding warm leads

Installation

Based on the project structure, this appears to be a service-based system rather than self-hosted code. Access is provided through:

# Official website for system access
https://www.facebook18.com

# Technical support and documentation
https://sites.google.com/view/facebook-script-custom/
https://sites.google.com/view/instagram-keyword-hashtag-lead/

Environment Setup

Store credentials securely using environment variables:

# .env file
WHATSAPP_API_KEY=your_api_key_here
WHATSAPP_PHONE_NUMBER=+1234567890
INSTAGRAM_USERNAME=your_username
INSTAGRAM_PASSWORD=your_password
TIKTOK_SESSION_TOKEN=your_session_token
PROXY_SERVER=http://proxy.example.com:8080

Core Features & Configuration

1. WhatsApp Mass Messaging

Bulk message sending to contacts or groups:

import os
from whatsapp_marketing import MassSender

# Initialize sender
sender = MassSender(
    api_key=os.getenv('WHATSAPP_API_KEY'),
    phone_number=os.getenv('WHATSAPP_PHONE_NUMBER')
)

# Send to contact list
contacts = ['+1234567890', '+0987654321']
message = "🔥 Special offer today only! Check out our new products at example.com"

sender.send_bulk_message(
    recipients=contacts,
    message=message,
    delay_between=5,  # seconds between messages
    randomize_delay=True
)

Group marketing:

# Send to multiple WhatsApp groups
groups = ['group_id_1', 'group_id_2', 'group_id_3']

sender.send_to_groups(
    group_ids=groups,
    message="Join our exclusive community! Link: example.com/join",
    schedule_time="2026-06-01 10:00:00"  # Optional scheduled send
)

2. Instagram Follower Extraction

Extract followers from competitor accounts:

from instagram_scraper import FollowerExtractor

extractor = FollowerExtractor(
    username=os.getenv('INSTAGRAM_USERNAME'),
    password=os.getenv('INSTAGRAM_PASSWORD'),
    proxy=os.getenv('PROXY_SERVER')
)

# Extract competitor's followers
competitor_followers = extractor.get_followers(
    target_account='competitor_username',
    max_followers=5000,
    filters={
        'min_followers': 100,
        'max_followers': 10000,
        'is_verified': False,
        'has_profile_picture': True
    }
)

# Save to CSV
extractor.export_to_csv(competitor_followers, 'leads.csv')

Hashtag-based lead extraction:

# Find users posting with specific hashtags
hashtag_leads = extractor.search_by_hashtag(
    hashtags=['fitness', 'workout', 'gym'],
    engagement_filters={
        'min_likes': 50,
        'min_comments': 5,
        'posted_within_days': 30
    },
    max_results=1000
)

# Filter by demographics
filtered_leads = extractor.filter_by_demographics(
    users=hashtag_leads,
    criteria={
        'age_range': [18, 35],
        'gender': 'any',
        'location': ['US', 'UK', 'CA']
    }
)

3. TikTok User Extraction

Extract engaged users from competitor videos:

from tiktok_scraper import TikTokExtractor

tiktok = TikTokExtractor(
    session_token=os.getenv('TIKTOK_SESSION_TOKEN')
)

# Get users who liked/commented on competitor videos
engaged_users = tiktok.extract_engaged_users(
    video_url='https://tiktok.com/@competitor/video/123456789',
    extraction_type='both',  # 'likes', 'comments', or 'both'
    max_users=2000
)

# Extract followers from competitor profile
competitor_followers = tiktok.get_profile_followers(
    username='competitor_username',
    max_followers=10000
)

4. Automated Engagement

Auto-follow, like, and comment:

from social_automation import EngagementBot

bot = EngagementBot(
    platform='instagram',
    credentials={
        'username': os.getenv('INSTAGRAM_USERNAME'),
        'password': os.getenv('INSTAGRAM_PASSWORD')
    }
)

# Configure engagement campaign
campaign = bot.create_campaign(
    name='Competitor Targeting Q2',
    actions={
        'follow': True,
        'like_posts': 3,  # Like 3 recent posts per user
        'comment': True,
        'send_dm': True
    },
    targets=filtered_leads,
    daily_limit=200,  # Max actions per day
    comment_templates=[
        'Great content! 🔥',
        'Love this! 💯',
        'Amazing post! ✨'
    ],
    dm_template='Hi! I love your content. Check out our page @yourpage 🚀'
)

# Start automated engagement
bot.run_campaign(campaign)

5. Multi-Account Management

Manage multiple social accounts:

from account_manager import MultiAccountManager

manager = MultiAccountManager()

# Add accounts
manager.add_account('instagram', {
    'username': 'account1',
    'password': os.getenv('IG_ACCOUNT1_PASSWORD')
})

manager.add_account('instagram', {
    'username': 'account2',
    'password': os.getenv('IG_ACCOUNT2_PASSWORD')
})

# Rotate accounts for actions
manager.distribute_actions(
    action_type='follow',
    targets=competitor_followers,
    actions_per_account=100
)

Common Patterns

Lead Generation Workflow

# Complete lead generation and outreach workflow
def automated_lead_funnel():
    # 1. Extract leads from multiple sources
    ig_leads = extractor.get_followers('competitor1', max_followers=5000)
    tiktok_leads = tiktok.get_profile_followers('competitor2', max_followers=5000)
    hashtag_leads = extractor.search_by_hashtag(['yourindustry'], max_results=1000)
    
    # 2. Combine and deduplicate
    all_leads = list(set(ig_leads + tiktok_leads + hashtag_leads))
    
    # 3. Filter high-quality leads
    qualified_leads = extractor.filter_by_demographics(
        users=all_leads,
        criteria={
            'min_followers': 200,
            'max_followers': 50000,
            'has_business_account': False,
            'engagement_rate': 0.02  # 2% minimum
        }
    )
    
    # 4. Automated engagement
    bot.create_campaign(
        name='Auto Funnel',
        actions={'follow': True, 'like_posts': 2, 'send_dm': True},
        targets=qualified_leads,
        daily_limit=150
    )
    
    # 5. Export for WhatsApp follow-up
    phone_numbers = extract_phone_numbers(qualified_leads)
    sender.send_bulk_message(
        recipients=phone_numbers,
        message="Special offer for Instagram followers! Use code IG20: example.com"
    )

automated_lead_funnel()

Scheduled Campaign Management

from scheduler import CampaignScheduler

scheduler = CampaignScheduler()

# Schedule daily follower extraction
scheduler.add_task(
    name='Daily Competitor Scrape',
    function=extractor.get_followers,
    args=['competitor_username'],
    kwargs={'max_followers': 500},
    schedule='daily',
    time='09:00'
)

# Schedule engagement waves
scheduler.add_task(
    name='Morning Engagement',
    function=bot.run_campaign,
    schedule='daily',
    time='10:00'
)

scheduler.add_task(
    name='Evening Engagement',
    function=bot.run_campaign,
    schedule='daily',
    time='18:00'
)

scheduler.start()

API Rate Limiting & Safety

Implement safe usage patterns:

from safety import RateLimiter, ActionThrottler

# Configure rate limits
limiter = RateLimiter(
    max_follows_per_hour=50,
    max_likes_per_hour=100,
    max_comments_per_hour=30,
    max_dms_per_hour=20
)

# Use throttler in campaigns
throttler = ActionThrottler(limiter)

def safe_engagement(targets):
    for user in targets:
        # Check rate limits before action
        if throttler.can_follow():
            bot.follow_user(user)
            throttler.record_action('follow')
            
        if throttler.can_like():
            bot.like_recent_posts(user, count=2)
            throttler.record_action('like', count=2)
            
        # Random delay to mimic human behavior
        throttler.human_delay(min_seconds=10, max_seconds=30)

Troubleshooting

Account Suspension Prevention

# Use rotating proxies
from proxy_rotator import ProxyPool

proxy_pool = ProxyPool([
    'http://proxy1.example.com:8080',
    'http://proxy2.example.com:8080',
    'http://proxy3.example.com:8080'
])

extractor = FollowerExtractor(
    username=os.getenv('INSTAGRAM_USERNAME'),
    password=os.getenv('INSTAGRAM_PASSWORD'),
    proxy_pool=proxy_pool,
    rotate_every_n_requests=50
)

Session Management

# Handle session expiration
try:
    followers = extractor.get_followers('target_account')
except SessionExpiredError:
    extractor.refresh_session()
    followers = extractor.get_followers('target_account')

Data Export & Integration

# Export to multiple formats
from exporters import DataExporter

exporter = DataExporter()

# CSV export
exporter.to_csv(leads, 'leads.csv', columns=['username', 'followers', 'email'])

# JSON export
exporter.to_json(leads, 'leads.json')

# CRM integration (example: HubSpot)
exporter.to_crm(
    leads,
    crm='hubspot',
    api_key=os.getenv('HUBSPOT_API_KEY'),
    custom_fields={'lead_source': 'Instagram Competitor Scrape'}
)

Best Practices

  1. Always respect platform rate limits to avoid account bans
  2. Use proxy rotation for large-scale extraction
  3. Randomize delays between actions (10-60 seconds)
  4. Store credentials securely in environment variables
  5. Monitor daily action limits (follows, likes, DMs)
  6. Test campaigns on small groups before scaling
  7. Comply with GDPR/privacy laws when collecting user data
  8. Use multiple accounts to distribute workload

Support & Documentation

For implementation support, contact the technical team through the official channels listed above.

FAQ

What does the whatsapp-mass-sender-group-marketing skill do?

Automate WhatsApp mass messaging, group marketing, and TikTok/Instagram follower extraction for targeted outreach campaigns

How do I install whatsapp-mass-sender-group-marketing?

Run npx skills add https://github.com/reason-machines/marketing-skills --skill whatsapp-mass-sender-group-marketing in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/whatsapp-mass-sender-group-marketing/ (personal) or .claude/skills/whatsapp-mass-sender-group-marketing/ (project).

Which AI agents can use whatsapp-mass-sender-group-marketing?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is whatsapp-mass-sender-group-marketing safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains whatsapp-mass-sender-group-marketing?

It is published by reason-machines in reason-machines/marketing-skills. It has 796 recorded installs.

More from reason-machines/marketing-skills

View all →

marketing-for-founders-saas-growth

reason-machines/marketing-skills

Access curated marketing strategies and channels to acquire the first 10/100/1000 users for SaaS products and startups

Marketing & SEO1.1K installs

agentkits-marketing-automation

reason-machines/marketing-skills

Enterprise AI marketing automation toolkit with 18 agents, 93 commands, and 28 skills for campaign planning, content creation, SEO, CRO, and growth workflows

Marketing & SEO1K installs

SEO & content marketing skill suite with keyword research, content audits, technical SEO, competitor analysis, and AI-powered content workflows

Marketing & SEO1K installs

ai-marketing-skills-automation

reason-machines/marketing-skills

Open-source AI marketing automation skills for growth experiments, sales pipeline, content ops, outbound, SEO, and finance automation

Marketing & SEO1K installs

marketingskills-ai-agent-collection

reason-machines/marketing-skills

Marketing skills collection for AI agents - CRO, copywriting, SEO, analytics, and growth engineering

AI & Agents1K installs

ai-marketing-claude-suite

reason-machines/marketing-skills

Comprehensive AI marketing automation suite for Claude Code with 15 skills including website audits, copywriting, email sequences, ad campaigns, competitive analysis, and PDF reporting

Marketing & SEO1K installs

Popular marketing & seo skills

View category →

reddit-automation

flowkit-labs/skills

Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.

Marketing & SEO1.1M installs

twitter-automation

101-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO880K installs

twitter-automation

magentosh/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO771.7K installs

twitter-automation

qu-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO564.3K installs

product-launch-video

heygen-com/hyperframes

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Marketing & SEO538.7K installs

twitter-automation

skills-shell/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO453.7K installs