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
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
- 01 You create a monitor with a plain-English description, input URL, schedule, and webhook.
- 02 Meerkat fetches the page (or tracking source) on your schedule.
- 03 Your LLM key interprets the page against your instruction — price drop, status change, copy update.
- 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