Developer Docs

Customer language, in your terminal and Claude.

Adlicio ships a commentscraper CLI and a hosted MCP connector. Pull ranked angles, pains, and hooks, mined from real comments on Reddit, YouTube, Amazon, and more, straight into your scripts or any Claude chat.

All Access required

The CLI and MCP connector ship with every All Access plan. Pro covers Reddit scraping; All Access unlocks every source plus the developer tools below.
Quickstart

From install to your first scrape.

01, Install the CLI globally with npm.

Terminal
npm install -g commentscraper

02, Authorize this machine (opens your browser).

Terminal
commentscraper login

Manage or revoke authorized devices anytime from your account.

03, Pull comments from any supported thread as JSON.

Terminal
commentscraper scrape "https://reddit.com/r/startups/comments/abc123/post/" --format json --quiet
CLI reference

Every commentscraper command.

commentscraper login

Authorize this machine. Opens your browser to sign in, then stores the token locally.

commentscraper whoami

Show which Adlicio account the CLI is currently authenticated as.

commentscraper platforms

List every source you can scrape on your current plan.

commentscraper research "back pain remedies" --quiet

Mine ranked angles, pains, and hooks for a topic across every available source.

commentscraper search "crm software frustrations" --quiet

Find the threads and comments most relevant to a query.

commentscraper scrape "<thread-url>" --format json --quiet

Pull the comments from a single thread URL. Use --format csv or text and --output <file> to save.

commentscraper mcp

Run the CLI as a local stdio MCP server for Claude Desktop.

Non-interactive auth

For CI or servers where you can't open a browser, pass the token through an environment variable instead of login:
Terminal
COMMENTSCRAPER_CLI_TOKEN=<token> commentscraper scrape "<url>" --format json --quiet
MCP connector

Add Adlicio to Claude.

Adlicio runs as a hosted remote MCP connector for Claude web, mobile, Cowork, and Desktop. No install needed.

Remote connector URL

https://mcp.tryadlicio.com/mcp

Claude web, mobile, Cowork

  1. 01Open Claude and go to Customize > Connectors.
  2. 02Click +, then choose Add custom connector.
  3. 03Name it Adlicio and paste https://mcp.tryadlicio.com/mcp.
  4. 04Click Add, then Connect.
  5. 05Sign in with the Google account you use for Adlicio or the Reddit Comment Scraper extension.
  6. 06In a chat, open + > Connectors and enable Adlicio for that conversation.

Team and Enterprise

  1. 01An Owner adds the connector in Organization settings > Connectors.
  2. 02Choose Custom > Web and paste the same remote MCP URL.
  3. 03Each team member then connects their own Adlicio account from Customize > Connectors.
Local MCP

Run the connector on your machine.

For Claude Desktop's local MCP, install the CLI, run commentscraper login, then add the server to your claude_desktop_config.json. This is separate from the hosted web connector above.

claude_desktop_config.json
{
  "mcpServers": {
    "commentscraper": {
      "command": "commentscraper",
      "args": ["mcp"]
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Tools exposed

research_topicRanked angles, pains, and hooks for a topic.
search_redditSearch Reddit threads for a query.
scrape_urlPull comments from a single supported URL.
whoamiReturn the connected Adlicio account.
Platforms

Sources you can scrape.

Pro covers Reddit. All Access unlocks every source below, plus the CLI and the MCP connector.

Redditreddit.com/r/startups/comments/abc123/post/Pro
YouTubeyoutube.com/watch?v=jNQXAC9IVRwAll Access
Amazonamazon.com/product-reviews/B08N5WRWNWAll Access
Trustpilottrustpilot.com/review/www.example.comAll Access
Etsyetsy.com/listing/560282270/custom-mugAll Access
Steamstore.steampowered.com/app/730/All Access

Get an All Access key and start scraping.

The CLI and MCP connector ship with every All Access plan.