Documentation

Everything you need to get from a Reel, TikTok, or Shorts URL to insight.

Getting Started

How to Transcribe a Short-Form Video

Paste any public Reel, TikTok, or YouTube Short — no account needed for your first analysis. Sign up free for 5 analyses a month, full history, and shareable links.

  1. Copy the URL of any public short-form video (Instagram Reel, TikTok, or YouTube Short), for example https://www.instagram.com/reel/ABC123/
  2. Paste it into the input field on the Lomero dashboard
  3. Click Analyze — your transcript and breakdown will be ready in under 30 seconds
  4. Read, copy, or export the full transcript with timestamps. Download the source MP4 from the video player if you want the file.

Supported Content

TypeSupported
Instagram Reels (public)✅ Yes
TikTok (public)✅ Yes
YouTube Shorts (public)✅ Yes
Local MP4 upload🔜 Coming soon
Instagram Stories / Posts❌ Not yet
Private or restricted content❌ No (requires public access)

Languages: 40+ languages supported. Highest accuracy for English, Spanish, Portuguese, French, German, and Turkish.

Features

Transcript

Full text with timestamps. Export as TXT or Markdown.

AI Analysis (full access)

  • Hook Score (0–100%)
  • Hook Pattern Detection
  • Retention Probability
  • Content Pillars
  • Structure Breakdown
  • Audience Signal

Hook & CTA Extraction

Side-by-side view of the opening hook (first 10–15s) and closing CTA (last 10–15s).

Content Breakdown

  • Format identification (Tutorial, Story, Hot Take, Listicle, Case Study)
  • Per-segment duration
  • Pacing analysis

Repurpose & Remix

  • Blog post draft (~400 words)
  • Tweet thread (5–7 tweets)
  • LinkedIn post (150–300 words)

Access

Lomero is free during early access. Anonymous visitors get 1 full AI analysis per day. Sign up free to get 5 analyses a month, saved history, and shareable links — no card required.

  1. Click Sign In or Sign Up in the header.
  2. Create an account with Google or email — no invite required.
  3. You'll land on /analyze with 5 monthly analyses ready to use.

Full walkthrough: How to get full access to Lomero.

Paid plans are not currently offered. If they are introduced in the future, existing users will not be auto-enrolled.

MCP Integration

Available on Pro and Agency plans. Allows Claude to directly analyze Instagram Reels.

What is MCP?

An open standard for AI assistants to interact with external tools natively. Install once, and Claude gains the ability to “see” and analyze Reels on your behalf.

Prerequisites

  • Claude Desktop app (or any MCP-compatible client)
  • Lomero Pro or Agency subscription
  • Your Lomero API key (Account → API Keys)

Installation

Step 1 — Add to MCP config. Open the Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "lomero": {
      "command": "npx",
      "args": ["-y", "@lomero/mcp-server"],
      "env": {
        "LOMERO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Step 2— Restart Claude Desktop. You should see “Lomero” appear in the tools list.

Step 3 — Start analyzing. Example prompts:

  • “Analyze the latest Reel from @username and tell me what hook pattern they used.”
  • “Transcribe this Reel and write a LinkedIn post based on it: https://www.instagram.com/reel/ABC123/”

Available MCP Tools

ToolDescription
lomero_transcribeTranscribes a Reel URL and returns full text with timestamps
lomero_analyzeRuns full AI analysis: hook score, pattern, content pillars, structure
lomero_hookExtracts and returns just the opening hook and closing CTA
lomero_repurposeGenerates a blog post, tweet thread, or LinkedIn post from the transcript

FAQ

Is Lomero free right now?

Yes. Lomero is free during early access — no card required. Anonymous visitors get 1 full AI analysis per day. Sign up free for 5 analyses a month, saved history, and shareable links. No paid plans yet.

Why does my transcript have inaccuracies?

Our engine aims for high accuracy on clear speech in supported languages. Accuracy can drop with heavy background music, strong accents, overlapping voices, or low audio quality.

Can I analyze private or restricted videos?

No. Lomero only processes publicly accessible content on Instagram, TikTok, and YouTube.

Does Lomero store my transcripts?

Only if you explicitly save them to your account. Output is generated on-demand and discarded after your session otherwise.

Will MCP work with Claude in my browser?

MCP is currently supported in Claude Desktop. Support for Claude.ai web and other MCP-compatible clients is expanding.

Can I use a REST API without the MCP?

A direct REST API is on our roadmap. The programmatic integration today is via the MCP server.

Troubleshooting

“Could not process this URL”

  • Confirm the video is public on the source platform
  • Use the direct video URL (not a profile, explore, or search URL)
  • The creator's account must not be set to private

“Analysis unavailable”

Full hook analysis requires a Lomero account (free, no invite needed). See Access for sign-up steps.

MCP not showing in Claude

  • Confirm claude_desktop_config.json is valid JSON
  • Restart Claude Desktop completely (quit from system tray)
  • Verify your API key is correct and your account has MCP access enabled

Support