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: INLINECODE13
Auth
- -
signal-track login --api-key <api_key> validates the key using the backend endpoint and stores user context locally.
Topic commands
Topics commands
- - INLINECODE16
- INLINECODE17
- INLINECODE18
- INLINECODE19
- INLINECODE20
- INLINECODE21
News cards
- - INLINECODE22
- INLINECODE23
- INLINECODE24
- INLINECODE25 (positional alias)
- INLINECODE26
Articles
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
-
signal-track --help
- INLINECODE37
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.
功能概述
signal-track 是一个AI原生信息追踪系统及CLI工具,用于持续性的主题化情报监控。signal-track既非传统新闻阅读器,也非通用推荐流。该系统围绕长期运行的主题构建:用户定义持续性追踪任务,平台持续监控信息源,检测有意义的更新,过滤噪音,并呈现高价值信号。换言之,它将一次性信息查询转化为持续性追踪任务。
- * 追踪持续主题(如OpenAI发布动态、NVIDIA财报、中国政策变化)
- 聚合多信息源更新
- 去重并结构化传入信息
- 提供摘要更新和时间线
- 支持特定事件的深度分析
适用场景
在以下情况下使用signal-track:
- * 需要持续监控某个主题
- 希望避免错过重要更新
- 追踪快速变化领域(AI、金融、政策等)
- 需要结构化、决策相关的信息而非原始新闻
以下情况请勿使用signal-track:
- * 通用浏览或娱乐内容
- 纯粹的一次性琐事或随机浏览(除非用户明确要求一次性新闻/文章搜索或浏览)
核心概念
- * 主题:可通过自然语言描述、结构化关键词和实体引用表达的长期信息追踪任务。
- 新闻卡片:传递给用户(或代理)的原子信息单元。
* 典型内容:标题、概述、ELI5、来源、时间戳和主题映射。
* 示例:新闻网站、博客、社交媒体、研究出版物、官方公告和公司发布。
- * 信息流:与主题或用户关注主题相关的新闻卡片流,按时间倒序排列。
关键功能
- * 创建和管理主题
- 订阅/取消订阅主题
- 按ID检索主题详情
- 在追踪信号内搜索
- 获取完整文章内容
- 对选定项目触发深度分析
使用示例
- * 追踪公司(如特斯拉、苹果)用于投资决策
- 监控AI模型发布和基准测试进展
- 关注某地区的政策或监管变化
- 追踪竞争对手或特定产品
- 提供复杂信息的简化解释(易于理解的摘要)
覆盖的CLI命令
所有现有signal-track CLI命令均通过辅助脚本支持:
- - 命令运行器:signal-track <参数>
认证
- - signal-track login --api-key 使用后端端点验证密钥并在本地存储用户上下文。
主题命令
- - signal-track topic show --topic-id id> [--cursor ] [--page-size size>]
主题列表命令
- - signal-track topics my
- signal-track topics list
- signal-track topics follow --topic-id id>
- signal-track topics unfollow --topic-id id>
- signal-track topics search --scope my --query [--page-size size>] [--page-number number>]
- signal-track topics search --scope square --query [--page-size size>] [--page-number number>]
新闻卡片
- - signal-track newscards feed my [--cursor ] [--page-size size>]
- signal-track newscards feed --topic-id id> [--cursor ] [--page-size size>]
- signal-track newscards get --news-id id>
- signal-track newscards get id> (位置别名)
- signal-track newscards search --query
文章
- - signal-track articles content --article-id
执行说明
- 需要Node.js 22+。
- - API基础URL默认为https://younews.k.sohu.com/。
- 所需本地配置状态:
- 从~/.openclaw/openclaw.json读取认证信息(优先)。如果不存在,则回退到旧版~/.signal-track/config.json。
- 将登录状态写入检测到的现有配置路径(如果存在openclaw则写入该路径,否则写入旧版配置路径)。
- 如果缺少--json,输出为人类可读的JSON风格美化打印,但特殊卡片获取行为除外(仅打印第一张卡片)。
安装与部署
- - 前提条件:Node.js 22+(node -v)。
- 从本地源码安装:
- npm install
- signal-track --help
- signal-track
错误处理
- - 如果未登录,命令会返回明确提示,引导执行signal-track login --api-key 。
- 缺少必需标志(例如--topic-id、--news-id、--article-id、--query或--scope)时会报告错误并打印命令帮助信息。
- 无效的分页值(负数/零/非整数)会在任何网络调用前返回验证错误。
平台说明
signal-track由YouNews作为底层引擎驱动,可视为YouNews的CLI版本;仅对YouNews会员开放——更多信息请访问younews.cn。