Skip to content
Back to search

elmo

SkillWorks with Claude CodeGitHub

Open-source Answer Engine Optimization (AEO) and Generative Engine Optimization (GEO) platform. Track how ChatGPT, Claude, Perplexity, Gemini, Copilot, Grok, and Google AI Overviews mention and cite your brand in AI search. MIT-licensed, self-hostable, every metric auditable in code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/elmohq/elmo with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/elmohq/elmo'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/elmohq--elmo/badge.svg)](/listings/elmohq--elmo)

HTML

<a href="/listings/elmohq--elmo"><img src="/api/listings/elmohq--elmo/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> [!TIP] > **Would rather not self-host?** Elmo Cloud runs the same open-source platform for you, with managed hosting and automatic updates, from $29/mo. [Start with Cloud →](https://www.elmohq.com/pricing)

For local deployments, use Docker Compose as configured with the `@elmohq/cli` package:

# Install the CLI globally
npm install -g @elmohq/cli

# Initialize configuration (interactive wizard)
elmo init

# Start the stack
elmo compose up -d

You'll need API keys for at least one AI provider or scraper, plus a [TypeSafe](https://console.typesafe.ai) key for Jev, which judges mentions and sentiment. Jev costs very roughly $0.15–0.35 per 1,000 answers: about $2–4 a month for 25 prompts on 3 platforms, or $11–26 for 100 prompts on 5. See [mention judging](https://www.elmohq.com/docs/developer-guide/configuration#mention-judging).

Once the services report healthy, open **http://localhost:1515** and create your account. The full walkthrough is in the [getting started guide](https://www.elmohq.com/docs/getting-started).

> [!TIP] > **Watch** this repo's **releases** to get notified of major updates.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 244 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://www.elmohq.com/">
  3. <img src="apps/www/public/brand/logos/elmo-logo-xl.png" alt="Elmo" width="300">
  4. </a>
  5. </p>
  6. <p align="center">
  7. Open source AI visibility tracking and optimization.
  8. <br />
  9. <br />
  10. <a href="https://www.elmohq.com/"><strong>Learn more »</strong></a>
  11. </p>
  12. <br />
  13. <p align="center">
  14. <a href="https://www.elmohq.com/docs"><img src="https://img.shields.io/badge/Docs-2563eb?style=flat&logo=readthedocs&logoColor=white" alt="Docs"></a>&nbsp;
  15. <a href="https://demo.elmohq.com"><img src="https://img.shields.io/badge/Demo-22c55e?style=flat&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgc3Ryb2tlPSJ3aGl0ZSIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjxwYXRoIGQ9Ik0xNSAxNGMuMi0xIC43LTEuNyAxLjUtMi41IDEtLjkgMS41LTIuMiAxLjUtMy41QTYgNiAwIDAgMCA2IDhjMCAxIC4yIDIuMiAxLjUgMy41LjcuNyAxLjMgMS41IDEuNSAyLjUiLz48cGF0aCBkPSJNOSAxOGg2Ii8+PHBhdGggZD0iTTEwIDIyaDQiLz48L3N2Zz4%3D" alt="Demo"></a>&nbsp;
  16. <a href="https://github.com/elmohq/elmo/issues"><img src="https://img.shields.io/badge/Issues-f95738?style=flat&logo=github&logoColor=white" alt="Issues"></a>&nbsp;
  17. <a href="https://github.com/orgs/elmohq/projects/3/views/1"><img src="https://img.shields.io/badge/Roadmap-ee964b?style=flat&logo=github&logoColor=white" alt="Roadmap"></a>&nbsp;
  18. <a href="https://discord.gg/s24nubCtKz"><img src="https://img.shields.io/badge/Discord-5865F2?style=flat&logo=discord&logoColor=white" alt="Discord"></a>
  19. </p>
  20. <br />
  21. > [!TIP]
  22. > **Don't want to self-host?** Elmo Cloud runs the same open-source platform for you, with managed hosting and automatic updates, from $29/mo. [Start with Cloud →](https://www.elmohq.com/pricing)
  23. ## About
  24. Elmo is an open-source, self-hosted platform for optimizing your AI visibility, which is also known as:
  25. * Answer Engine Optimization (AEO)
  26. * Generative Engine Optimization (GEO)
  27. * LLM Optimization (LLMO, which is where the name Elmo is from)
  28. Buyers increasingly ask AI before they search or visit a website. Elmo tracks how AI answer engines like ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews mention, cite, and describe your brand, so you can benchmark competitors, uncover citation gaps, and win more recommendations in AI answers.
  29. It's an open-source alternative to tools like [Profound](https://www.elmohq.com/ai-visibility-tools/alternatives/profound), [Peec](https://www.elmohq.com/ai-visibility-tools/alternatives/peec-ai), and [Otterly](https://www.elmohq.com/ai-visibility-tools/alternatives/otterly-ai). You can run it on your own infrastructure, own your data, and audit exactly how every metric is calculated.
  30. ## Demo
  31. Try the live demo at **[demo.elmohq.com](https://demo.elmohq.com)** to see how Elmo tracks prompts and analyzes citations.
  32. ## Screenshots
  33. | Dashboard Overview | Visibility Tracking |
  34. |---|---|
  35. | ![Elmo overview with visibility, share of voice, sentiment, and position cards above a competitive landscape](apps/www/public/screenshots/overview.png) | ![Per-prompt AI visibility scores and trends across answer engines](apps/www/public/screenshots/visibility.png) |
  36. | **Share of Voice** | **Citation Analysis** |
  37. | ![Competitor share of voice leaderboard and trend over time](apps/www/public/screenshots/share-of-voice.png) | ![Domains and URLs cited by AI answer engines, grouped by category](apps/www/public/screenshots/citations.png) |
  38. | **Query Fan-Out** | **Opportunities** |
  39. | ![Web searches AI engines ran while grounding answers to tracked prompts](apps/www/public/screenshots/query-fan-out.png) | ![Generated recommendations for earning more AI citations](apps/www/public/screenshots/opportunities.png) |
  40. | **Sentiment** | **Responses** |
  41. | ![Sentiment score, trends against competitors, sentiment by model, and the passages behind it](apps/www/public/screenshots/sentiment.png) | ![Every AI answer for a brand, with each company's position and sentiment](apps/www/public/screenshots/responses.png) |
  42. ## What Elmo Tracks
  43. - **[Visibility](https://www.elmohq.com/features/ai-visibility-tracking)** — how often each AI engine mentions your brand for every tracked prompt, per prompt and per model, trended over time. Mentions are matched on your name, aliases, and domains, then confirmed by a judge model.
  44. - **[Share of voice](https://www.elmohq.com/features/share-of-voice)** — a competitor leaderboard and how your share of mentions moves over time.
  45. - **[Sentiment and position](https://www.elmohq.com/features/sentiment-analysis)** — whether each answer is positive, neutral, mixed, or negative toward you and each competitor, where you rank among the companies named, and the exact passage behind every judgment.
  46. - **[Citations](https://www.elmohq.com/features/citation-tracking)** — every URL an engine cites, grouped by domain and category (yours, competitors', social, Google, institutional), so you know which pages AI trusts in your category.
  47. - **[Query fan-out](https://www.elmohq.com/features/query-fan-out)** — the web searches engines run before answering, how they rewrite your prompts, and which searches your content wins or misses.
  48. - **[Prompt tracking](https://www.elmohq.com/features/prompt-tracking)** — an onboarding wizard that suggests prompts, competitors, and personas from your website, plus manual prompts and tags.
  49. - **[Opportunities](https://www.elmohq.com/features/aeo-recommendations)** — a prioritized list of what to create, pitch, and seed to earn more AI citations.
  50. - **[Reports](https://www.elmohq.com/features/ai-visibility-reporting)** — shareable visibility reports stakeholders can open without an Elmo account.
  51. - **[API, SDKs, and MCP](https://www.elmohq.com/features/api-and-mcp)** — a REST API with TypeScript and Python SDKs, and an MCP server for Claude Code, Cursor, Codex, and VS Code.
  52. ## How Elmo Measures AI Visibility
  53. 1. **Prompts** — the questions your buyers ask AI, generated from your website or written by hand.
  54. 2. **Runs** — a worker runs every prompt several times a day on each engine you track. [Multi-engine tracking](https://www.elmohq.com/features/multi-engine-tracking) scrapes the real consumer apps (ChatGPT, Google AI Mode, Google AI Overviews, Gemini, Bing AI Mode) and calls model APIs for Claude, Perplexity, Grok, and others; the [providers guide](https://www.elmohq.com/docs/user-guide/providers) compares the options.
  55. 3. **Analysis** — each answer is stored raw in PostgreSQL with its citations and fan-out searches, then [Jev](https://typesafe.ai) judges which companies it really mentions, the sentiment toward each, and the passage that shows it.
  56. 4. **Metrics** — visibility is the share of runs that mention you; sentiment scores positive 100, neutral and mixed 50, negative 0; position averages your rank among companies named. Everything filters by prompt, tag, engine, and date.
  57. Every step is code in this repo, and every number can be re-derived from the raw answers it came from.
  58. ## Elmo vs. Closed-Source Alternatives
  59. Most AI visibility platforms are closed SaaS. Here is how Elmo compares to the widely used ones:
  60. | Tool | Open Source | Auditable Metrics | Self-Hosted | Cloud |
  61. |---|---|---|---|---|
  62. | [**Elmo**](https://www.elmohq.com/) | Yes (MIT) | Yes | Free | From $29/mo |
  63. | [Profound](https://www.elmohq.com/ai-visibility-tools/elmo-vs-profound) | No | No | No | Enterprise, custom pricing |
  64. | [Peec AI](https://www.elmohq.com/ai-visibility-tools/elmo-vs-peec-ai) | No | No | No | From $95/mo |
  65. | [Otterly AI](https://www.elmohq.com/ai-visibility-tools/elmo-vs-otterly-ai) | No | No | No | From $29/mo |
  66. | Tool | ChatGPT | Google AI Mode | Google AI Overviews | Gemini | Copilot | Claude |
  67. |---|:---:|:---:|:---:|:---:|:---:|:---:|
  68. | **Elmo** | ✅ | ✅ | ✅ | ✅ | Bing AI Mode | ✅ |
  69. | Profound | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
  70. | Peec AI | ✅ | ✅ | ✅ | ✅ | ✅ | Enterprise |
  71. | Otterly AI | ✅ | Add-on | ✅ | Add-on | ✅ | Add-on |
  72. ## Who Elmo Is For
  73. - **Marketing, SEO, and content teams** extending their search strategy to AI search — see which prompts your brand wins or misses, which competitors AI recommends instead, and which cited pages to target next.
  74. - **Agencies** offering Answer Engine Optimization to clients: track every client brand in one place, and use the white-label deployment for custom branding, a custom domain, and SSO.
  75. - **B2B SaaS and e-commerce brands** that need to show up when buyers ask AI for "best [category]" shortlists, comparisons, and product recommendations.
  76. - **Software companies** embedding AI visibility tracking into their own products instead of building and maintaining the scraping and analysis pipeline themselves.
  77. - **Developers and analysts** who want auditable metrics — a REST API with TypeScript and Python SDKs, an MCP server for AI assistants, a documented methodology, and a database you can query directly instead of a dashboard-only black box.
  78. - **Self-hosting and regulated teams** who need AI visibility data inside their own infrastructure — your prompts, your competitors, and every raw engine response stay in a PostgreSQL database you control.
  79. - **Anyone priced out of enterprise AEO platforms** who still needs credible measurement of how ChatGPT, Perplexity, Gemini, and Google AI Overviews talk about their brand.
  80. See how teams in specific industries use Elmo: [AEO by industry](https://www.elmohq.com/aeo-for).
  81. ## Quick Start
  82. The recommended setup uses two API keys:
  83. - **[Cloro](https://cloro.dev?fpr=elmo&fp_sid=readme)** scrapes the real ChatGPT, Google AI Mode, Google AI Overviews, and Gemini apps.
  84. - **[OpenRouter](https://openrouter.ai)** runs onboarding, opportunities, and Jev, the model that judges mentions and sentiment.
  85. Then install the CLI, which walks you through configuration, and start the stack with Docker Compose:
  86. ```bash
  87. npm install -g @elmohq/cli
  88. elmo init
  89. elmo compose up -d
  90. ```
  91. See the [getting started guide](https://www.elmohq.com/docs/getting-started) for the full walkthrough and the [providers guide](https://www.elmohq.com/docs/user-guide/providers) for other scrapers and model APIs.
  92. ## MCP Server
  93. Elmo's MCP server lets an AI client read your visibility data and manage the prompts Elmo tracks. Full setup for every client is in the [MCP docs](https://www.elmohq.com/docs/api/mcp).
  94. - **Endpoint:** `https://app.elmohq.com/api/mcp` on Elmo Cloud, or `<APP_URL>/api/mcp` on a self-hosted instance
  95. - **Transport:** Streamable HTTP (remote server, nothing to install locally)
  96. - **Authentication:** sign in from the client with OAuth (no app to register), or send an API key from **Settings → API Keys** as `Authorization: Bearer elmo_...`. A key can be read-only and limited to selected brands.
  97. | Tool | What It Does |
  98. | --- | --- |
  99. | `whoami` | What this connection is and what it can access |
  100. | `list_models` | The AI models this instance knows about and which it tracks |
  101. | `list_brands`, `get_brand` | Brands you track and their domains, aliases, models, and cadence |
  102. | `list_competitors` | Competitors tracked for a brand |
  103. | `list_prompts`, `list_prompt_tags` | Tracked prompts and their tags |
  104. | `get_analytics` | Visibility, share of voice, sentiment, and position over a time window |
  105. | `get_prompt_performance` | The same metrics broken down by prompt |
  106. | `get_citations` | The pages and domains AI answers cite |
  107. | `get_query_fanout` | The web searches models ran before answering |
  108. | `get_opportunities` | The latest opportunities report: what to write, what to fix, and the risks found |
  109. | `list_runs`, `get_run` | Recorded answers for a prompt, and one answer's full text and citations |
  110. | `get_billing` | Plan and usage |
  111. | `create_prompts`, `update_prompt` | Add and edit tracked prompts (needs write access) |
  112. A connection is only offered the tools its access allows. No tool deletes data.
  113. **Claude Code** — then run `/mcp` and choose **Authenticate**:
  114. ```bash
  115. claude mcp add --transport http elmo https://app.elmohq.com/api/mcp
  116. ```
  117. With an API key instead:
  118. ```bash
  119. claude mcp add --transport http elmo https://app.elmohq.com/api/mcp \
  120. --header "Authorization: Bearer elmo_..."
  121. ```
  122. **VS Code** — run `code --add-mcp '{"name":"elmo","type":"http","url":"https://app.elmohq.com/api/mcp"}'`, or add it to `mcp.json` (omit `headers` to sign in with OAuth instead):
  123. ```json
  124. {
  125. "servers": {
  126. "elmo": {
  127. "type": "http",
  128. "url": "https://app.elmohq.com/api/mcp",
  129. "headers": { "Authorization": "Bearer elmo_..." }
  130. }
  131. }
  132. }
  133. ```
  134. **Cursor, Codex, Claude.ai, ChatGPT, and others** — see the [MCP docs](https://www.elmohq.com/docs/api/mcp), or configure every client on your machine at once with `npx add-mcp https://app.elmohq.com/api/mcp --name elmo`.
  135. ## Skill
  136. The [`aeo` skill](skills/aeo/SKILL.md) teaches Claude Code, Cursor, Codex, and other coding agents an evidence-based answer engine optimization workflow: measure, diagnose, fix, then measure again. It works with or without Elmo, and it can read Elmo's data over MCP.
  137. ```bash
  138. npx skills add elmohq/elmo
  139. ```
  140. Or copy [`skills/aeo`](skills/aeo) into your agent's skills directory (for Claude Code, `~/.claude/skills/aeo`). On claude.ai, zip the `aeo` folder and upload it in the Skills settings.
  141. ## Deployment Options
  142. - **Self-Hosted** — Run Elmo for free on your own infrastructure using Docker Compose. [Get started →](https://www.elmohq.com/docs/getting-started)
  143. - **Elmo Cloud** — Managed hosting with automatic updates, unlimited seats, and API and MCP access on every plan. [See plans →](https://www.elmohq.com/pricing)
  144. - **White-Label** — Elmo Cloud with your own branding, domain, and SSO, built for agencies and software companies. [Book a call →](https://www.elmohq.com/demo)
  145. ## Architecture and Tech Stack
  146. <p align="center">
  147. <img src="apps/www/public/brand/architecture.svg" alt="Elmo system architecture" width="100%">
  148. </p>
  149. A web app serves the dashboard and REST API, a worker schedules and executes prompt runs against the AI engines, and PostgreSQL stores both the data and the job queue. The [developer guide](https://www.elmohq.com/docs/developer-guide) covers the monorepo layout and how to contribute.
  150. - [Docker Compose](https://docs.docker.com/compose/)
  151. - [PostgreSQL](https://www.postgresql.org/)
  152. - [TypeScript](https://www.typescriptlang.org/)
  153. - [TanStack Start](https://tanstack.com/start/latest)
  154. - [pg-boss](https://github.com/timgit/pg-boss)
  155. ## Documentation
  156. - [Getting started](https://www.elmohq.com/docs/getting-started) — self-host Elmo in under five minutes
  157. - [User guide](https://www.elmohq.com/docs/user-guide) — brand setup, prompts, visibility, sentiment, citations, and reports
  158. - [Providers](https://www.elmohq.com/docs/user-guide/providers) — choosing scrapers and model APIs for each answer engine
  159. - [Developer guide](https://www.elmohq.com/docs/developer-guide) — architecture, configuration, and contributing
  160. - [API reference](https://www.elmohq.com/docs/api) — the REST API, TypeScript and Python SDKs, and MCP server
  161. - [AI Visibility Tool Directory](https://www.elmohq.com/ai-visibility-tools) — 100+ AEO/GEO tools compared
  162. ## Sponsors
  163. <p align="left">
  164. <a href="https://www.searchapi.io/?utm_source=github&utm_medium=sponsorship&utm_campaign=google_search_api&utm_content=elmohq_elmo"><img src="https://nynjceth7hnajxhe.public.blob.vercel-storage.com/sponsors/searchapi-card.png" alt="SearchApi" width="210"></a>
  165. <a href="https://www.llumohq.com/?ref=elmo"><img src="https://nynjceth7hnajxhe.public.blob.vercel-storage.com/sponsors/llumo-card.png" alt="Llumo" width="210"></a>
  166. <a href="https://scavio.dev/aeo?via=elmo"><img src="https://nynjceth7hnajxhe.public.blob.vercel-storage.com/sponsors/scavio-card.png" alt="Scavio" width="210"></a>
  167. </p>
  168. <a href="https://github.com/sponsors/elmohq"><strong>Become a sponsor →</strong></a>
  169. ## Contact
  170. - [Discord](https://discord.gg/s24nubCtKz)
  171. - [Email](mailto:support@elmohq.com)
  172. - [Schedule a Call](https://www.elmohq.com/demo)
  173. ## Contributing
  174. See [CONTRIBUTING.md](CONTRIBUTING.md), the [developer guide](https://www.elmohq.com/docs/developer-guide), and [good first issues](https://github.com/elmohq/elmo/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).
  175. ## License
  176. Elmo is open source under the [MIT License](LICENSE.md).
  177. ## Repo Activity
  178. ![Repository activity](https://www.elmohq.com/repo-activity.svg "Repository activity")

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.