CLI for TechSnif

Quick Start

The public CLI is API-only. It talks to https://api.techsnif.com, does not need API keys, and exposes only the stable public command set.

npx @techsnif/cli stories --sort newest --limit 5 --json

TechSnif CLI for OpenClaw

TechSnif CLI is a strong fit for OpenClaw because it is direct, JSON-friendly, and easy to wrap in skills. But it is not OpenClaw-specific. The same commands work for local shell scripts, CI jobs, agent runtimes, internal automations, and any workflow that wants a clean terminal interface to public TechSnif data.

If you want a ready-made OpenClaw skill, use the TechSnif skill on ClawHub.

If you prefer chat-native tool use, use MCP. If you prefer command execution and shell composition, use the CLI. Both sit on top of the same public intelligence surface.

Install

Install globally if you want a persistent techsnif command, or run it on demand with npx. The current release is v0.6.1.

npm install -g @techsnif/cli

npx @techsnif/cli --help

What You Can Do

The public package (v0.6.1) exposes thirteen read-only commands. Story commands return story clusters: ranked groupings of coverage from multiple publishers (TechCrunch, The Verge, Ars Technica, Reuters, and others). TechSnif is just another source in the cluster alongside the original outlets.

Watch: the live stream

techsnif watch --topics ai --tier 2

Command Reference

Every command supports --json and --api-url.

Example Commands

techsnif stories --json
techsnif stories --sort newest --limit 10 --json
techsnif stories --publisher TechCrunch --json
techsnif stories --topic ai --tier 3 --json
techsnif stories --platform x --has-discussion --json
techsnif story meta-youtube-social-media-trial --json
techsnif story meta-youtube-social-media-trial --platform x --json
techsnif search "AI chip shortage" --json
techsnif timeline meta-youtube-social-media-trial --json
techsnif changes --since 2026-08-17T00:00:00Z --json
techsnif trending --type stories --hours 12 --json
techsnif watch --topics ai --tier 2
techsnif articles --category AI --json
techsnif articles search "robotics" --json
techsnif article ai-chip-shortage-deep-dive --brief --json
techsnif leaderboard --tab authors --window 7d --json
techsnif events --json
techsnif platforms --json

JSON Output

Every public command supports --json. Request/response commands return a stable envelope that works well for shell pipelines, automation, and AI tools. watch --json streams one JSON object per line instead.

{
  "ok": true,
  "data": {},
  "targetEnv": "https://api.techsnif.com"
}

Public Scope

The public CLI is intentionally narrow. It only ships read-only public commands and does not expose private operator workflows, direct database access, or internal provenance tooling.

Development Overrides

The default target is https://api.techsnif.com. For local development or staging, override it with --api-url.

techsnif stories --api-url http://localhost:4321 --json

CLI vs MCP

Use the CLI when you want something direct and scriptable from a terminal, especially in OpenClaw-style skill workflows. Use MCP when you want an AI client like Claude Desktop or Cursor to call TechSnif tools inside chat.

Security Notes

The public package is API-only and intentionally constrained for public distribution. It does not bundle internal ops code, does not require credentials, and is designed to be safe for general use against TechSnif's public API.

The CLI also sanitizes terminal-bound output and rejects non-HTTP API targets, so it stays boring in the best way: simple, read-only, and predictable.