How It Works
- You create listener subscriptions (source type + query + cadence)
- An hourly cron polls all listeners that are due
- New items are deduplicated and stored as raw discoveries
- The
content-listener-evaluatorrunner scores each item for relevance - Items above the relevance threshold become opportunities in the Content Planner feed
Available Sources
YouTube and Google Search listeners require platform API keys. Configure them in Settings → Integrations before creating listeners for those sources.
Creating a Listener
Click Add Source in the Sources tab and choose a source type. Each source has its own configuration fields: Reddit- Subreddit name (without the
r/prefix) - Sort order: Hot, New, or Top
- Max results per poll (default 25)
- Search query (topic or keywords)
- Optional: Channel ID to scope results to a specific creator
- Topic or search query to track
- Query string
- Optional: Site scope (e.g.,
site:competitor.com) - Time range filter (past day, week, month, or year)
- Feed URL (RSS 2.0 or Atom format)
Poll Cadences
Choose how often each listener checks for new content:Recent Discoveries
Below the subscriptions table, a Recent Discoveries feed shows every item the system has fetched, along with its evaluation status:
Each item also shows evaluation tags once scored: the ICP match label, detected intent (informational, commercial, navigational), and the suggested asset type (blog post, FAQ, landing page, etc.).
How Evaluation Works
Thecontent-listener-evaluator runner scores every new discovery across five criteria:
- Niche relevance — Does this topic belong in your content space?
- ICP match — Would your target audience care about this?
- Novelty — Is this meaningfully different from content you’ve already published?
- Quality signal — Is the source and format worth reacting to?
- Timeliness — Is this still fresh enough to be worth producing?
For opportunities identified as blog-type content, a second runner —
content-listener-researcher — enriches the opportunity with keyword research data from your connected SEO tools before it appears in the feed.