# Send Fatsecret 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": "fatsecret", "name": "Fatsecret", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/f-liva/fatsecret", "canonicalUrl": "https://clawhub.ai/f-liva/fatsecret", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/fatsecret", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fatsecret", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "examples/agent_usage_example.py", "references/api.md", "requirements.txt", "scripts/fatsecret-cli.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "fatsecret", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-03T04:21:46.851Z", "expiresAt": "2026-05-10T04:21:46.851Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fatsecret", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fatsecret", "contentDisposition": "attachment; filename=\"fatsecret-1.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "fatsecret" }, "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/fatsecret" }, "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/fatsecret", "downloadUrl": "https://openagent3.xyz/downloads/fatsecret", "agentUrl": "https://openagent3.xyz/skills/fatsecret/agent", "manifestUrl": "https://openagent3.xyz/skills/fatsecret/agent.json", "briefUrl": "https://openagent3.xyz/skills/fatsecret/agent.md" } } ``` ## Documentation ### FatSecret Nutrition API Complete integration with FatSecret for food data lookup AND diary logging. ### ⚠️ Authentication Methods This skill supports two authentication methods for different use cases: MethodUse CaseUser Login RequiredCapabilitiesOAuth2 (client_credentials)Read-only access❌ NoFood search, barcode lookup, recipesOAuth1 (3-legged)Full access✅ Yes (one-time PIN)All above + diary logging ### Which to use? Just searching foods? → OAuth2 (simpler, no user login) Logging to user's diary? → OAuth1 (requires user authorization) ### 1. Get API Credentials Go to https://platform.fatsecret.com Register an application Copy your Consumer Key and Consumer Secret ### 2. Save Credentials mkdir -p ~/.config/fatsecret cat > ~/.config/fatsecret/config.json << EOF { "consumer_key": "YOUR_CONSUMER_KEY", "consumer_secret": "YOUR_CONSUMER_SECRET" } EOF ### 3. Install Dependencies cd /path/to/fatsecret-skill python3 -m venv venv source venv/bin/activate pip install -r requirements.txt ### 4a. For Read-Only (OAuth2) - No user login needed # Search works immediately ./scripts/fatsecret-cli.sh search "chicken breast" ### 4b. For Diary Logging (OAuth1) - One-time user authorization # Run authentication flow ./scripts/fatsecret-cli.sh auth # Follow prompts: # 1. Visit the authorization URL # 2. Log in with FatSecret account # 3. Authorize the app # 4. Enter the PIN shown # Now you can log foods ./scripts/fatsecret-cli.sh quick egg 3 Breakfast ### 📋 CLI Commands CommandAuth RequiredDescriptionsearch OAuth2Search foodsbarcode OAuth2Barcode lookuprecipes OAuth2Search recipesauth-Run OAuth1 authenticationlogOAuth1Add food to diary (interactive)quick [qty] [meal]OAuth1Quick log to diary ### For OpenClaw Agents from scripts.fatsecret_agent_helper import ( get_authentication_flow, complete_authentication_flow, save_user_credentials ) # Check authentication status state = get_authentication_flow() if state["status"] == "need_credentials": # Ask user for Consumer Key/Secret # Save with: save_user_credentials(key, secret) pass elif state["status"] == "need_authorization": # Show authorization URL to user url = state["authorization_url"] # User visits URL, authorizes, gets PIN # Complete with: complete_authentication_flow(pin) pass elif state["status"] == "already_authenticated": # Ready to use diary functions from scripts.fatsecret_diary_simple import quick_log quick_log("egg", quantity=3, meal="Breakfast") ### Agent Helper Functions FunctionDescriptionget_authentication_flow()Check status, returns next stepsave_user_credentials(key, secret)Save API credentialscomplete_authentication_flow(pin)Complete OAuth1 with PINquick_log(food, qty, meal)Log food to diarylog_food(food_id, serving_id, grams_or_ml, meal, name)Precise loggingsearch_food(query, tokens)Search foods ### ⚠️ IMPORTANT: How grams_or_ml Works The grams_or_ml parameter (called number_of_units in FatSecret API) is the ACTUAL amount, not a multiplier! # ❌ WRONG - This logs only 1.56 grams (7 kcal)! log_food(food_id, serving_100g_id, 1.56, "Breakfast", "Cookies") # ✅ CORRECT - This logs 156 grams (741 kcal) log_food(food_id, serving_100g_id, 156, "Breakfast", "Cookies") Examples: What you wantServing typegrams_or_ml value156g of cookies"100g" serving156200ml of milk"100ml" serving2003 eggs"1 large egg" serving32 slices of bread"1 slice" serving2 ### 🔐 Credential Storage All credentials and tokens are stored locally: FileContentsCreated By$CONFIG_DIR/config.jsonConsumer Key/SecretUser (manual)$CONFIG_DIR/oauth1_access_tokens.jsonOAuth1 access tokensauth command$CONFIG_DIR/token.jsonOAuth2 token (auto-refreshed)OAuth2 client Where $CONFIG_DIR is ~/.config/fatsecret by default, or the value of FATSECRET_CONFIG_DIR if set. To revoke access: Delete the config folder and revoke app access from your FatSecret account settings. ### 🐳 Container/Docker Environments In containerized environments (Docker, OpenClaw sandbox), ~/.config/ may not persist across restarts. Use FATSECRET_CONFIG_DIR to point to a persistent volume: # Set env var to persistent directory export FATSECRET_CONFIG_DIR="/home/node/clawd/config/fatsecret" # Or prefix commands FATSECRET_CONFIG_DIR="/persistent/path" ./scripts/fatsecret-cli.sh auth OpenClaw example - add to your shell init or AGENTS.md: export FATSECRET_CONFIG_DIR="/home/node/clawd/config/fatsecret" ### 🌐 Proxy Configuration (Optional) Some FatSecret API plans require IP whitelisting. If needed, set a proxy: # Environment variable export FATSECRET_PROXY="socks5://127.0.0.1:1080" # Or in config.json { "consumer_key": "...", "consumer_secret": "...", "proxy": "socks5://127.0.0.1:1080" } If you don't need a proxy: The skill works without it. Proxy is only required if FatSecret blocks your IP. ### 🌍 Open Food Facts (Alternative) For European products, use the free Open Food Facts API (no authentication): from scripts.openfoodfacts_client import OpenFoodFactsClient off = OpenFoodFactsClient(country="it") products = off.search("barilla") product = off.get_product("8076800105735") # Barcode ### 📁 File Structure fatsecret/ ├── SKILL.md # This documentation ├── README.md # GitHub/ClawHub readme ├── requirements.txt # Python: requests, requests[socks] ├── scripts/ │ ├── fatsecret-cli.sh # Main CLI (bash wrapper) │ ├── fatsecret_auth.py # OAuth1 3-legged authentication │ ├── fatsecret_agent_helper.py # Helper functions for agents │ ├── fatsecret_diary_simple.py # Diary logging (OAuth1) │ ├── fatsecret_client.py # OAuth2 client (read-only) │ └── openfoodfacts_client.py # Open Food Facts client └── examples/ └── agent_usage_example.py # Agent integration example ### ⚠️ Security Notes Credentials are stored locally in ~/.config/fatsecret/ OAuth1 tokens don't expire unless you revoke them OAuth1 grants full access to your FatSecret diary (read + write) To uninstall safely: Delete ~/.config/fatsecret/ and revoke app from FatSecret account ### 🔗 References FatSecret API: https://platform.fatsecret.com/docs OAuth1 Guide: https://platform.fatsecret.com/docs/guides/authentication/oauth1/three-legged Open Food Facts: https://wiki.openfoodfacts.org/API ### v1.0.1 (2026-02-20) Fixed OAuth2 client - now uses OAuth1 for all operations (food search + diary) Unified authentication: single OAuth1 flow works for both read and write operations Removed broken OAuth2 implementation ## Trust - Source: tencent - Verification: Indexed source record - Publisher: f-liva - Version: 1.1.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-03T04:21:46.851Z - Expires at: 2026-05-10T04:21:46.851Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/fatsecret) - [Send to Agent page](https://openagent3.xyz/skills/fatsecret/agent) - [JSON manifest](https://openagent3.xyz/skills/fatsecret/agent.json) - [Markdown brief](https://openagent3.xyz/skills/fatsecret/agent.md) - [Download page](https://openagent3.xyz/downloads/fatsecret)