# Send Ynab Api to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "ynab-api", "name": "Ynab Api", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/f-liva/ynab-api", "canonicalUrl": "https://clawhub.ai/f-liva/ynab-api", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/ynab-api", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ynab-api", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "_meta.json", "references/api-guide.md", "references/category-examples.md", "scripts/daily-budget-check.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "ynab-api", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-11T08:20:11.949Z", "expiresAt": "2026-05-18T08:20:11.949Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ynab-api", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ynab-api", "contentDisposition": "attachment; filename=\"ynab-api-2.4.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "ynab-api" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/ynab-api" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/ynab-api", "downloadUrl": "https://openagent3.xyz/downloads/ynab-api", "agentUrl": "https://openagent3.xyz/skills/ynab-api/agent", "manifestUrl": "https://openagent3.xyz/skills/ynab-api/agent.json", "briefUrl": "https://openagent3.xyz/skills/ynab-api/agent.md" } } ``` ## Documentation ### YNAB Budget Management Manage your YNAB budget via the API with ready-to-use bash scripts. Requires curl and jq. ### Configuration Set environment variables YNAB_API_KEY and YNAB_BUDGET_ID, or create ~/.config/ynab/config.json: { "api_key": "YOUR_YNAB_TOKEN", "budget_id": "YOUR_BUDGET_ID", "monthly_target": 2000 } The monthly_target field sets your monthly spending cap (used by daily-spending-report.sh). Can also be set via YNAB_MONTHLY_TARGET env var. Get your token at https://app.ynab.com/settings/developer. Find your Budget ID in the YNAB URL. ### Available Scripts All scripts are in {baseDir}/scripts/ and output to stdout. ScriptPurposedaily-spending-report.shYesterday's expenses by category + monthly budget progress + analysisdaily-budget-check.shMorning overview: Age of Money, upcoming bills, overspending alertsgoals-progress.sh [month]Visual progress bars for category goalsscheduled-upcoming.sh [days]Upcoming scheduled transactions (default: 7 days)month-comparison.sh [m1] [m2]Month-over-month spending comparisontransfer.sh SRC DEST AMT DATE [MEMO]Create a properly linked account transferynab-helper.sh General helper: search payees, list categories, add transactionssetup-automation.shTest config and list available scripts ### Amounts use milliunits YNAB API represents all amounts in milliunits: 10.00 = 10000, -10.00 = -10000. Always divide by 1000 when displaying, multiply by 1000 when submitting. ### Always categorize transactions Never create transactions without a category -- it breaks budget tracking. When encountering an unfamiliar merchant, search past transactions for the same payee and reuse the category for consistency. ### Check for pending transactions before adding Before creating a new transaction, check if an unapproved one already exists for the same amount. If found, approve it instead. This avoids duplicates from bank imports. ### Transfers require transfer_payee_id To create a real linked transfer between accounts, use the destination account's transfer_payee_id (not payee_name). Using payee_name creates a regular transaction that YNAB won't recognize as a transfer. See references/api-guide.md for the full transfer guide. ### Split transactions Transactions with category "Split" contain subtransactions. Always expand them to show subcategories in reports -- never show "Split" as a category name. ### Common API Operations YNAB_API="https://api.ynab.com/v1" # Add a transaction # POST \\/budgets/\\/transactions # Body: {"transaction": {"account_id": "UUID", "date": "2026-03-06", "amount": -10000, "payee_name": "Coffee Shop", "category_id": "UUID", "approved": true}} # Search transactions by payee # GET \\/budgets/\\/transactions | jq filter by payee_name # List categories # GET \\/budgets/\\/categories For the complete transfer guide, monthly spending calculation, and account ID management, see references/api-guide.md. For category naming examples, see references/category-examples.md. ### Agent Guidance Always categorize at transaction creation time -- searching past transactions for the same payee is the best way to find the right category. For transfers, always use transfer_payee_id from the destination account. Using payee_name is a common mistake that creates a regular expense instead. When calculating monthly spending, only count amount < 0 and consider excluding non-discretionary categories (taxes, transfers). Rate limit is ~200 requests/hour. Cache account and category data when doing bulk operations. Never log or display full API keys in output. When running daily-spending-report.sh, the script outputs an "ANALYSIS DATA" section with raw metrics. Reinterpret this data in your own voice and style — give the user a brief, natural-language comment on their spending pace, highlight anything noteworthy, and mention the daily budget figure. ### Troubleshooting 401 Unauthorized: Token invalid or expired -- regenerate at https://app.ynab.com/settings/developer 404 Not Found: Budget ID wrong -- check the YNAB URL 429 Too Many Requests: Rate limit -- add delays between bulk calls Transfer not linking: Using payee_name instead of transfer_payee_id API docs: https://api.ynab.com ## Trust - Source: tencent - Verification: Indexed source record - Publisher: f-liva - Version: 2.3.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-11T08:20:11.949Z - Expires at: 2026-05-18T08:20:11.949Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/ynab-api) - [Send to Agent page](https://openagent3.xyz/skills/ynab-api/agent) - [JSON manifest](https://openagent3.xyz/skills/ynab-api/agent.json) - [Markdown brief](https://openagent3.xyz/skills/ynab-api/agent.md) - [Download page](https://openagent3.xyz/downloads/ynab-api)