@signal4/s4
v2.1.2
Published
Signal4 media intelligence — CLI and MCP server for AI agents
Maintainers
Readme
@signal4/s4
Media intelligence CLI and MCP server for AI agents.
Search quotes, analyze discourse, track trends, and explore speakers across thousands of hours of audiovisual content.
CLI
# Install globally
npm install -g @signal4/s4
# Or run directly
npx @signal4/s4 search "tariffs" --speaker "Trudeau" --days 7Setup
s4 setup # Save your API key
s4 whoami # Verify accessCommands
# 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:
{
"mcpServers": {
"signal4": {
"command": "npx",
"args": ["-y", "@signal4/s4", "--mcp"],
"env": {
"SIGNAL4_API_KEY": "your-api-key" # pragma: allowlist secret
}
}
}
}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)
