Log in Sign up →

Introduction

Meerkat Cloud is Change Intelligence for Ruby apps. You describe what to watch in plain English — Meerkat checks it on a schedule, understands what changed, and POSTs a signed webhook only when it matters.

What Meerkat solves

Most “monitoring” stacks force you to build the same plumbing over and over: cron jobs, scrapers, diffing, retries, and webhook delivery. Meerkat collapses that into one API call from Rails.

  • No Sidekiq monitors for every competitor page or tracking URL
  • No brittle HTML diffs — an LLM (your key) decides what meaningful change looks like
  • No polling from your app — results push to your webhook when state moves
Product loop: free 1 monitor · 1 run → then $20 — 5 tasks, 50 runs. Install meerkat-agents, create a monitor, get a webhook.

Core concepts

Five ideas are enough to use Meerkat end to end:

Monitor

A recurring or one-shot job: description + URL/inputs + webhook. This is what you create from the gem or console.

Run

One execution of a monitor. Produces findings (structured output) and delivery status.

Webhook

HTTPS endpoint on your Rails app. Meerkat POSTs signed JSON when a run has something to report.

BYOK

Bring your own LLM key (Anthropic / OpenAI). Meerkat never resells tokens — you control cost and model.

Full definitions: Concepts →

How a monitor works

  1. 01 You create a monitor with a plain-English description, input URL, schedule, and webhook.
  2. 02 Meerkat fetches the page (or tracking source) on your schedule.
  3. 03 Your LLM key interprets the page against your instruction — price drop, status change, copy update.
  4. 04 When something meaningful changes, Meerkat POSTs signed JSON to your Rails webhook.
gem "meerkat-agents"
# bundle install

require "meerkat"

client = Meerkat::Client.new(api_key: ENV["MEERKAT_API_KEY"])

client.monitors.create(
  description: "Notify me when pricing or plan limits change",
  input_params: { url: "https://competitor.com/pricing" },
  frequency: "every 6 hours",
  output_webhook: "https://myapp.com/webhooks/meerkat"
)

What to read next

  • Quickstart — ship your first monitor in minutes
  • Concepts — monitors, runs, webhooks, credits
  • Use cases — website, packages, prices with code
  • Ruby SDK — gem install and Rails webhook verification