Monid

How to use the Monid CLI to execute data scraping and collection tasks from social media platforms, e-commerce sites, and search engines. Use this skill when the user needs to scrape data from Twitter/X, Instagram, TikTok, Facebook, LinkedIn, YouTube, Amazon, or Google Maps. This skill provides complete workflow guidance for authentication, task creation, price quotes, and execution monitoring. ALWAYS use this skill when the user mentions scraping, collecting, or extracting data from supported platforms, even if they don't explicitly say "Monid". Use this for queries like "find tweets about X", "scrape Instagram posts", "get Amazon product reviews", or any data collection from the supported platforms.

# Monid CLI Skill

Monid is an agentic payment platform CLI that enables secure, pay-per-use data scraping from various platforms. This skill teaches you how to help users accomplish data collection tasks using the Monid CLI.

## Core Concept

Monid follows a **quote-then-execute** workflow:
1. **Create a task** (defines what data to collect)
2. **Get a price quote** (shows cost before execution)
3. **Execute the search** (runs the scraping job)
4. **Monitor and retrieve results** (check status and download data)

## Prerequisites

Before using Monid for data scraping, the user must complete these one-time setup steps:

### 1. Install the Monid CLI

**Quick Install (Recommended)**:
```bash
curl -fsSL https://raw.githubusercontent.com/FeiyouG/monid-client/main/install.sh | bash
```

This downloads and installs the latest stable Monid CLI to `~/.local/bin/monid`.

**Verify installation**:
```bash
monid --version
```

Expected output: `monid v1.0.0` (or later version)

**Supported platforms**: Linux x64, macOS ARM64 (Apple Silicon), Windows x64

**Troubleshooting**:
- If `monid: command not found` after installation, restart your terminal or run `source ~/.bashrc` (or `~/.zshrc` for zsh)
- Ensure `~/.local/bin` is in your PATH
- For Windows or manual installation, download binaries from: https://github.com/FeiyouG/monid-client/releases/latest

### 2. Authenticate with OAuth

```bash
monid auth login
```

**What happens**:
1. CLI starts a local callback server on port 8918
2. Your browser opens to the authentication page
3. Sign in with your credentials (Google, GitHub, etc.)
4. Browser redirects back to the CLI
5. Workspace information is saved to `~/.monid/config.yaml`

**If browser doesn't open**: Copy the URL from the terminal and paste it into your browser manually.

**Verify authentication**:
```bash
monid auth whoami
```

Expected output shows your workspace and user email.

### 3. Generate API Key

```bash
monid keys generate --label main
```

**What happens**:
1. CLI generates an Ed25519 cryptographic key pair
2. Private key is encrypted and stored locally at `~/.monid/keys/`
3. Public key is automatically registered with the backend
4. Key is activated for signing your requests

**Verify key**:
```bash
monid keys list
```

Expected output shows your key marked with `*` (active).

### Setup Complete!

After these three steps, you're ready to execute searches. If the user hasn't completed these steps, guide them through installation, authentication, and key generation first before attempting any searches.

## Supported Capabilities

Monid can ONLY scrape data from these platforms and capabilities. **NEVER suggest capabilities outside this list**:

### X (Twitter)
- **X Tweet Scraper** (`apify#apidojo/tweet-scraper`)
  - Scrape tweets from search terms, profile handles, list URLs, tweet URLs
  - Advanced filters: date range, language, media type, engagement thresholds
  - Best for: Large-scale tweet collection, trend analysis, sentiment analysis

### Instagram
- **Instagram Scraper** (`apify#apify/instagram-scraper`)
  - Scrape posts from usernames, hashtags, locations
  - Returns: post metadata, engagement metrics
  - Best for: General Instagram content collection
  
- **Instagram Profile Scraper** (`apify#apify/instagram-profile-scraper`)
  - Extract profile information and related posts
  - Best for: Influencer analysis, account research
  
- **Instagram API Scraper** (`apify#apify/instagram-api-scraper`)
  - API-style structured data extraction
  - Best for: Programmatic integration pipelines
  
- **Instagram Hashtag Scraper** (`apify#apify/instagram-hashtag-scraper`)
  - Scrape hashtag pages and posts
  - Best for: Trend tracking, campaign monitoring
  
- **Instagram Post Scraper** (`apify#apify/instagram-post-scraper`)
  - Extract specific posts from URLs
  - Best for: Known post URLs

### TikTok
- **TikTok API Scraper** (`apify#scraptik/tiktok-api`)
  - Flexible scraping across profiles, videos, hashtags, search
  - Best for: Multi-purpose TikTok collection
  
- **TikTok Profile Scraper** (`apify#apidojo/tiktok-profile-scraper`)
  - Scrape creator profiles and metrics
  - Best for: Influencer tracking
  
- **TikTok Scraper** (`apify#apidojo/tiktok-scraper`)
  - Collect videos from profiles, hashtags, keywords, URLs
  - Best for: High-throughput content extraction
  
- **TikTok Post Scraper** (`apify#thenetaji/tiktok-post-scraper`)
  - Extract individual posts by URL
  - Best for: Specific video collection
  
- **TikTok Video Scraper** (`apify#clockworks/tiktok-video-scraper`)
  - Detailed video metadata extraction
  - Best for: Per-video focused extraction

### LinkedIn
- **LinkedIn Post Search** (`apify#harvestapi/linkedin-post-search`)
  - Find posts by keyword queries
  - Best for: Topic monitoring, brand discussions
  
- **LinkedIn Profile Search** (`apify#harvestapi/linkedin-profile-search`)
  - Search people profiles by role, company, location
  - Best for: Lead generation, market mapping
  
- **LinkedIn Job Search** (`apify#powerai/linkedin-job-search-scraper`)
  - Collect job listings from searches
  - Best for: Hiring intelligence, talent mapping
  
- **LinkedIn Company Search** (`apify#powerai/linkedin-company-search-scraper`)
  - Find company pages and organization data
  - Best for: Company prospecting

### YouTube
- **YouTube Scraper** (`apify#streamers/youtube-scraper`)
  - Scrape videos from searches, channels, video URLs
  - Best for: Broad YouTube data collection
  
- **YouTube Comments Scraper** (`apify#streamers/youtube-comments-scraper`)
  - Collect comments and thread metadata
  - Best for: Sentiment analysis, engagement research
  
- **YouTube Scraper (API Dojo)** (`apify#apidojo/youtube-scraper`)
  - High-volume, cost-effective scraping
  - Best for: Scalable YouTube collection
  
- **YouTube Video Transcript** (`apify#starvibe/youtube-video-transcript`)
  - Fetch video transcripts with timing
  - Best for: Summarization, semantic search, NLP

### Facebook
- **Facebook Reviews Scraper** (`apify#apify/facebook-reviews-scraper`)
  - Scrape reviews from Facebook pages
  - Best for: Reputation monitoring
  
- **Facebook Events Scraper** (`apify#apify/facebook-events-scraper`)
  - Extract event listings and metadata
  - Best for: Event intelligence
  
- **Facebook Marketplace Scraper** (`apify#curious_coder/facebook-marketplace`)
  - Scrape marketplace listings
  - Best for: Market monitoring, competitor analysis
  
- **Facebook Pages Scraper** (`apify#apify/facebook-pages-scraper`)
  - Extract page data and content
  - Best for: Page monitoring
  
- **Facebook Groups Scraper** (`apify#apify/facebook-groups-scraper`)
  - Scrape public group posts
  - Best for: Community monitoring
  
- **Facebook Comments Scraper** (`apify#apify/facebook-comments-scraper`)
  - Extract comments from posts/pages
  - Best for: Sentiment analysis
  
- **Facebook Ads Library Scraper** (`apify#curious_coder/facebook-ads-library-scraper`)
  - Scrape ads library data
  - Best for: Competitive research, ad intelligence

### Amazon
- **Amazon Product Scraper** (`apify#delicious_zebu/amazon-product-scraper`)
  - Scrape product details from URLs: pricing, reviews, ratings, availability
  - Best for: Product research, price monitoring
  
- **Amazon Reviews Scraper** (`apify#axesso_data/amazon-reviews-scraper`)
  - Scrape customer reviews and ratings
  - Best for: Review analysis, sentiment research
  
- **Amazon Search Scraper** (`apify#axesso_data/amazon-search-scraper`)
  - Scrape search results with product listings
  - Best for: Market research, competitor analysis

### Google
- **Google Maps Scraper** (`apify#damilo/google-maps-scraper`)
  - Scrape businesses, cafes, restaurants, shops by query and location
  - Returns: name, address, phone, website, rating, reviews
  - **REQUIRED**: query (what to search) and location (where)
  - Best for: Local business data, competitor mapping

## Complete Workflow Guide

### Step 1: One-Time Setup

If the us