shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsAPI key required

signal-track

Track persistent topics (stocks, companies, AI, and policy events) and monitor them continuously. Use this for recurring updates, trend monitoring, and struc...

personAuthor: lucas-acchubclawhub
open_in_newRepositorydownloadDownload package

What it does

signal-track is an AI-native information tracking system and a CLI tool for continuous, topic-based intelligence monitoring. signal-track is not a traditional news reader and not a general recommendation feed. The system is built around long-running topics: users define persistent tracking tasks, and the platform continuously monitors information sources, detects meaningful updates, filters noise, and surfaces high-value signals. In other words, it converts one-time information queries into persistent tracking tasks.

  • Track ongoing topics (e.g. "OpenAI releases", "NVIDIA earnings", "China policy changes")
  • Aggregate updates from multiple information sources
  • Deduplicate and structure incoming information
  • Provide summarized updates and timelines
  • Support deep-dive analysis on specific events

When to use

Use signal-track when:

  • You need continuous monitoring of a topic over time
  • You want to avoid missing important updates
  • You are tracking fast-moving domains (AI, finance, policy, etc.)
  • You need structured, decision-relevant information instead of raw news

Do NOT use signal-track for:

  • General browsing or entertainment content
  • Pure one-off trivia or random browsing (unless the user explicitly asks for one-off news/article search or browsing)

Core concepts

  • Topic: A long-running information tracking task that can be expressed through a natural language description, structured keywords, and entity references.
  • NewsCard: The atomic information unit delivered to users(or agents).
    • Typical contents: title, overview, ELI5, sources, timestamp, and topic mapping.
  • Source: Any information producer the system monitors.
    • Examples: news websites, blogs, social media, research publications, official announcements, and company releases.
  • Feed: A stream of news cards associated with a topic or a user's followed topics, ordered recency.

Key capabilities

  • Create and manage topics
  • Subscribe/unsubscribe to topics
  • Retrieve topic details by id
  • Search within tracked signals
  • Fetch full article content
  • Trigger deep analysis on selected items

Example use cases

  • Track a company (e.g. Tesla, Apple) for investment decisions
  • Monitor AI model releases and benchmark progress
  • Follow policy or regulatory changes in a region
  • Track competitors or specific products
  • Provide simplified explanations of complex information (easy-to-understand summaries)

CLI surface covered

All existing signal-track CLI commands are supported through the helper script:

  • Command runner: signal-track <args>

Auth

  • signal-track login --api-key <api_key> validates the key using the backend endpoint and stores user context locally.

Topic commands

  • signal-track topic show --topic-id <topic_id> [--cursor <cursor>] [--page-size <page_size>]

Topics commands

  • signal-track topics my
  • signal-track topics list
  • signal-track topics follow --topic-id <topic_id>
  • signal-track topics unfollow --topic-id <topic_id>
  • signal-track topics search --scope my --query <keyword> [--page-size <page_size>] [--page-number <page_number>]
  • signal-track topics search --scope square --query <keyword> [--page-size <page_size>] [--page-number <page_number>]

News cards

  • signal-track news_cards feed my [--cursor <cursor>] [--page-size <page_size>]
  • signal-track news_cards feed --topic-id <topic_id> [--cursor <cursor>] [--page-size <page_size>]
  • signal-track news_cards get --news-id <news_id>
  • signal-track news_cards get <news_id> (positional alias)
  • signal-track news_cards search --query <keyword>

Articles

  • signal-track articles content --article-id <article_id>

Execution notes

  • Always keep commands in English.
  • Default environment:
    • Requires Node.js 22+.
  • API base URL defaults to https://younews.k.sohu.com/.
  • Required local config state:
    • Reads auth from ~/.openclaw/openclaw.json (preferred). If absent, falls back to legacy ~/.signal-track/config.json.
    • Writes login state to the detected existing config path (openclaw if present, otherwise legacy config path).
  • If --json is missing, output is human-readable JSON-style pretty print except for special card-get behavior where the first card is printed.

Installation and deployment

  • Prerequisite: Node.js 22+ (node -v).
  • Install from local source:
    • npm install
  • npm install -g .
    • signal-track --help
    • signal-track <command>

Error handling

  • If not logged in, commands return a clear message prompting signal-track login --api-key <api_key>.
  • Missing required flags (for example, --topic-id, --news-id, --article-id, --query, or --scope) are reported and command help is printed.
  • Invalid pagination values (negative/zero/non-integer) return validation errors before any network call.

Platform notes

signal-track is powered by YouNews as its underlying engine and can be considered the CLI version of YouNews; it is available exclusively to YouNews members — see younews.cn for more information.