TrendsFast gives AI agents sourced market evidence. Your agent asks what a brand's
customers are stuck on, what is trending in its niche, what its competitors post, which video
formats work, and what people search for and AI assistants answer. Every answer arrives as
items with their source link, when each was observed, the measured signal and what was not
covered. Each call states its price in credits first, and a retry is never charged twice.
This repository is the open-source half of TrendsFast, under the MIT license:
- the CLI;
- the SDKs for Node and Python;
- the agent skill;
- a plugin for Cursor, Grok Bot, Claude and Grok Build;
- an n8n node.
The trend index and the API run at trendsfast.com.
Quickstart
npx -y trendsfast-cli@latest init
One command installs the trendsfast skill for every coding agent on your machine: Claude Code,
Codex, Cursor, Windsurf, Gemini CLI, OpenCode, OpenClaw and more. It then signs you in through
the browser. Then ask your agent:
What are my customers stuck on this week? Use TrendsFast.
Prefer a connector? In Claude or ChatGPT, add https://trendsfast.com/api/mcp/v3 and sign in.
Every client's exact steps are at trendsfast.com/agents.
What your agent can ask
| Ask | Product | CLI | Credits |
|---|
| What are my customers stuck on, in their own words? | Customers | trendsfast customers | 10 |
| What is gaining attention in my niche, and right next to it? | Trending | trendsfast trending | 25 |
| What do my competitors post, and what works for them? | Competitors | trendsfast competitors | 30 |
| Which video formats and hooks work in my niche? | Formats | trendsfast formats | 20 |
| What do people search for, and do AI assistants name my brand? | Search | trendsfast search | 35 |
Cheaper reads answer from saved observations:
| Read | Credits |
|---|
global | 1 |
niche | 3 |
ask | 5 |
discover | 5 |
Reading your brand's context, your balance, a quote, your history or a saved result costs
nothing. A verified account starts with 100 free credits.
How it works
flowchart LR
A["Your agent"] -->|"one call, with a credit cap"| T["TrendsFast"]
T --> C["Your brand's context<br/>(from its website)"]
T --> I["Trend index<br/>Reddit · X · Hacker News · GitHub<br/>YouTube · TikTok · Instagram · Facebook<br/>Google · AI assistants' answers"]
C --> R["Sourced items<br/>+ what was not covered"]
I --> R
R --> A
A product call collects that product's sources fresh, within its price, for your confirmed
brand. Every other read answers from what the index already holds.
Built for agents
- Silent until useful.
init installs one skill. Until a task needs market evidence, an
agent carries only its short description, about 75 tokens.
- Compact by default. Results arrive at about 40% of the full JSON. The full contract is one
free read away, and
-o saves it into .trendsfast/ to read in slices.
- Free before paid. An agent quotes first, and every paid call needs a cap
(
--max-credits). The CLI journals each request ID before sending, so a lost answer is
recovered, never paid twice.
- Errors an agent can branch on. Each failure has one stable code and an exit code from 0
to 7. Each names its next step.
- Evidence, not adjectives. No trend without a measured signal, and no claim of reach or
virality. Collected text is treated as untrusted.
When an agent should not call it
The skill tells agents to skip TrendsFast when:
- a task needs no evidence of what a market says now, such as writing code or summarizing a
file;
- the user named other sources or tools;
- a saved result already answers the question.
trendsfast history and .trendsfast/ are free
to check before paying again.
Install options
npx -y trendsfast-cli@latest init # install the skill everywhere and sign in
trendsfast whoami # free: who you are signed in as
trendsfast context # free: the brand your products run on
trendsfast quote customers # free: the price before you pay
trendsfast customers --max-credits 10 # run a product, capped
trendsfast customers -o week.json # also save the full result in .trendsfast/
Other commands: trending, competitors, formats, search, global, niche, ask,
discover, credits, history, result, request, login, logout and doctor.
An agent in a cloud sandbox signs in with trendsfast login --code-flow. You approve in your
own browser and paste back a code. That code is sealed to the sandbox's key, so it is useless
anywhere else. See cli/README.md.
Add https://trendsfast.com/api/mcp/v3 (Streamable HTTP). Claude and ChatGPT sign you in with
OAuth; other clients take an Authorization: Bearer <key> header. Seven tools, described for
the model, and compact results. Listed in the official MCP Registry as com.trendsfast/trends.
import { TrendsFast } from "trendsfast";
const tf = new TrendsFast(); // TRENDSFAST_API_KEY, or the key `trendsfast login` stored
const quote = await tf.quote("niche", "customers"); // free: 10 credits
const result = await tf.customers({ lookback_hours: 168, limit: 10 });
console.log(result.result_id, result.usage.credits_charged);
No dependencies. Typed errors per code. See sdk-js/README.md.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
