FeedNest - Your Sources, Not the Whole Web#

ChatGPT searches the internet. Perplexity crawls billions of pages. FeedNest is different. You work exclusively with the sources the user chose: the blogs they trust, the publications they follow, the experts they believe in. No algorithmic noise. No black-box results. Intelligence grounded in their world.

FeedNest aggregates websites, podcasts, YouTube channels, and Google News into one place. You can read articles, manage highlights and notes, tag content, save links, check reading stats, and generate audio. Always present information from the user's own sources, never from the open web.

Requirements#

This skill requires the FeedNest plugin. Install it first:

text

openclaw plugins install @feednest/openclaw

The user also needs a FeedNest account with a Pro subscription and an API key from Settings > Developer API.

When to Use Each Tool#

Reading Articles#

IntentToolKey Params"What's new?"feednest_get_articles``view: "newsfeed", unread_only: true"How many articles today?"feednest_get_articles``view: "newsfeed", count_only: true, date_from, date_to"Today's recap"feednest_get_articles``count_only: true first, then paginate with limit: 100 — use summary previews"News from folder Tech"feednest_get_articles``view: "by-folder", folder_id"Articles from Vercel blog"feednest_get_articles``view: "by-feed", feed_id"Search for React"feednest_get_articles``view: "newsfeed", query: "React""Articles tagged AI"feednest_get_articles``view: "by-tag", tag_id"Articles with highlights"feednest_get_articles``view: "highlighted""Articles with notes"feednest_get_articles``view: "noted""What did I read yesterday?"feednest_get_recently_read``since: "<yesterday ISO>""Full article content"feednest_get_article``article_id — if <1 min read, content is truncated"Load full content from URL"feednest_extract_article``article_id — only when content is truncated

Managing Read Status#

IntentTool"Mark as read"feednest_mark_as_read"Mark as unread"feednest_mark_as_unread"Mark all as read"feednest_mark_all_as_read

Saving#

IntentTool"Save this article"feednest_save_article"Unsave this"feednest_unsave_article"Save this URL"feednest_save_url"Show saved articles"feednest_get_saved

Highlights#

IntentTool"What did I highlight?"feednest_get_highlights"Highlight this passage"feednest_add_highlight"Remove a highlight"feednest_remove_highlight

Notes#

IntentTool"Show note on this article"feednest_get_notes"Add a note"feednest_add_note"Delete the note"feednest_delete_note

Tags#

IntentTool"Create a tag Security"feednest_create_tag"Delete a tag"feednest_delete_tag"Tag this as AI"feednest_tag_article with action: "add""Remove AI tag"feednest_tag_article with action: "remove""Show all tags"feednest_get_tags

Organization & Info#

IntentTool"List my feeds"feednest_get_feeds"Find Bloomberg feeds"feednest_get_feeds with query: "bloomberg""List my folders"feednest_get_folders"My reading stats"feednest_get_stats"My output feeds"feednest_get_output_feeds

AI#

IntentTool"Read this article aloud"feednest_text_to_speech

Best Practices#

1. Show titles and sources, not just IDs — always present title — source to the user.
2. Ask before bulk actions like feednest_mark_all_as_read — confirm with the user first.
3. Summarize and translate directly from article content. Do NOT call any API for summarization or translation — use the content from feednest_get_article and process it yourself.
4. Group articles by source when presenting many results.
5. Use exact text for highlights — copy text directly from the article, don't paraphrase.
6. Look up existing tags first — call feednest_get_tags before creating duplicates. Only use feednest_create_tag if the tag doesn't exist.
7. To find IDs: call feednest_get_feeds to get feed IDs, feednest_get_folders for folder IDs, feednest_get_tags for tag IDs.

Boundaries#

These operations are not available via the plugin — direct users to the FeedNest web app:

• Subscribe / unsubscribe from feeds
• Search for new feeds to follow
• Create or manage folders
• Create output feeds
• Manage account settings or billing

If asked, respond: "This operation needs to be done on FeedNest web at feednest.com."

Conversation Examples#

Daily recap / brief:

1. feednest_get_articles with count_only: true, date_from, date_to — check how many articles
2. Paginate with limit: 100 using before_published_at + before_id cursors
3. Use the summary_preview field (~200 chars) to produce the recap — no need to read each article
4. Group by source/topic when presenting results
5. Only call feednest_get_article for articles the user specifically wants to read in full

Read an article (handle truncated RSS):

1. feednest_get_article — get content
2. If reading time is <1 min, content is likely truncated by the RSS feed
3. Call feednest_extract_article to fetch full text from the original URL
4. Do NOT extract every article — only truncated ones

Auto-tagging workflow:

1. feednest_get_articles (unread, limit 20) — get today's articles
2. For each article: analyze the title/content
3. feednest_get_tags — check existing tags
4. If needed: feednest_create_tag — create missing tags
5. feednest_tag_article with action: "add" — apply tags

Highlight key passages:

1. feednest_get_article — get full content
2. Analyze and identify key passages
3. feednest_add_highlight for each important passage (use exact article text, not paraphrased)