@signal4/s4 2.0.0

package/README.md

@@ -0,0 +1,92 @@
+# @signal4/s4
+
+Media intelligence CLI and MCP server for AI agents.
+
+Search quotes, analyze discourse, track trends, and explore speakers across thousands of podcasts and media channels.
+
+## CLI
+
+```bash
+# Install globally
+npm install -g @signal4/s4
+
+# Or run directly
+npx @signal4/s4 search "tariffs" --speaker "Trudeau" --days 7
+```
+
+### Setup
+
+```bash
+s4 setup                              # Save your API key
+s4 whoami                             # Verify access
+```
+
+### Commands
+
+```bash
+# Search
+s4 search "immigration" --speaker "Tucker Carlson"
+s4 claims "AI regulation" --entity "OpenAI"
+s4 trend "tariffs"
+
+# Explore
+s4 speaker "Joe Rogan"
+s4 speaker "Tucker Carlson" "economy"   # discourse search
+s4 channel "Power & Politics"
+s4 episode pod_8f1e55513f70 --transcript
+s4 segment 28553756
+s4 thread 28553756
+
+# Analyze
+s4 analyze "carbon tax" --days 14
+s4 compare "tariffs" --speakers "Trump,Biden"
+s4 dossier "immigration" --speaker "Carlson"
+s4 contradictions "vaccines" --speaker "Trump"
+s4 briefing
+
+# Reports
+s4 stats
+s4 top-speakers --ranking talkative
+s4 top-channels
+s4 network
+s4 topics
+
+# Ads
+s4 ads --trending
+
+# Bookmarks
+s4 bookmarks
+s4 bookmarks add segment 12345 --note "key quote"
+```
+
+All commands support `--json` for raw JSON output.
+
+## MCP Server
+
+For Claude Desktop, Cursor, or other MCP clients:
+
+```json
+{
+  "mcpServers": {
+    "signal4": {
+      "command": "npx",
+      "args": ["-y", "@signal4/s4", "--mcp"],
+      "env": {
+        "SIGNAL4_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Tool definitions are loaded dynamically from the API based on your key's access level.
+
+## Requirements
+
+- Node.js 18+
+- A Signal4 API key ([signal4.ca](https://signal4.ca))
+
+## Links
+
+- [Signal4](https://signal4.ca)
+- [API docs](https://signal4.ca/docs/api)

package/bin/s4.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+const args = process.argv.slice(2);
+if (args[0] === "mcp" || args.includes("--mcp")) {
+  await import("../dist/index.js");
+} else {
+  await import("../dist/cli.js");
+}

package/bin/signal4-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/index.js";

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+/** Signal4 CLI — terminal interface sharing handlers with the MCP server. */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAkpB7E,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAwD1C"}