Analyze feeds
analyze_feedsAnalyze feed health and explicit engagement to surface pruning candidates and estimate wasted posting volume using category-pooled Beta-Binomial bounds and optional volume sampling.
Instructions
Analyze feed health and explicit engagement with a category-pooled Beta-Binomial model (default 12 months, prior strength 10). By default counts starred, liked, broadcast and custom tags, excluding folders and passive system states; engagement_streams selects an explicit positive allowlist. Ordinary read flags are not engagement. Articles are deduplicated across positive streams. Categories with fewer than two engaged feeds use the global prior; multiple actual topic priors are averaged, excluding exclude_topic_folders. Reports exact equal-tailed 90% Beta bounds and posterior shapes only for complete, consistent counts. Missing, capped or failed coverage is unknown, not zero engagement. Retained engagement can exceed retained feed volume: this is flagged without silently flooring the denominator. Historical rates are retention/subscription-affected context, never authorization for automatic actions. Engagement and volume follow continuations within max_requests and the known 25-read reserve. Default sort unengaged_per_month estimates wasted posting volume; skipped sorts ascending by total minus engaged. Sorting engaged_count, title or days_since_newest skips engaged-feed volume reads; volume_sample optionally counts never-engaged active feeds. Costs 3 metadata reads plus engagement pages and optional volume pages EVERY call; no caching. max_requests counts base calls including failed calls; safe-read retries are extra (up to 4 attempts, counted in rate-limit status). Check get_rate_limit_status before large scans. See inoreader://usage for limits and URI examples.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "analyze_feeds"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max number of feeds to return (default 100). Use to keep response size manageable. | |
| folder | No | Limit analysis to feeds in this folder | |
| months | No | Time window in months to analyze (default 12) | |
| refresh | No | No-op, retained for compatibility. Reads are not cached between calls. | |
| sort_by | No | Sort results by (default: unengaged_per_month). skipped sorts ascending by total - engaged to find feeds you read almost everything from (Must Read candidates). unengaged_per_month ranks by estimated wasted articles per month to surface pruning candidates. Use credible_lower for conservative ranking that penalizes small samples more. | |
| max_requests | No | Maximum base Zone 1 calls across this workflow (default 100); retries are extra. Leaves 25 known requests in reserve and reports partial coverage. | |
| volume_sample | No | How many never-engaged active feeds to also count volume for, to rank noise (default 0). Set higher to find the noisiest unengaged feeds, at 1 extra API call each. | |
| prior_strength | No | Beta prior pseudo-observation count (default 10). Higher values shrink small-sample feeds more aggressively toward the global mean. | |
| engagement_pages | No | Per-tag safety cap on engagement pages (100 items per page, default 100). Pagination normally ends naturally when the ot time filter is exhausted; this cap only binds for users with thousands of engaged items per tag in the window. | |
| engagement_streams | No | Explicit positive stream IDs. Only these streams count as engagement; omit to retain the default explicit-action/custom-tag policy. Do not include negative or automation labels. | |
| exclude_topic_folders | No | Folder names or IDs excluded from category pooling (for example an operational priority folder); memberships are preserved. |