fatsecret

What This Skill Does

The FatSecret skill provides a comprehensive integration with the FatSecret Nutrition API, enabling users to access a vast database of food information and manage their personal dietary logs. It supports both read-only operations like searching for food items, looking up detailed nutritional information (calories, macros, micronutrients), and scanning product barcodes, as well as read-write operations such as searching for recipes and logging meals directly to a user's FatSecret diary. The skill offers two authentication methods: OAuth2 for simple read-only access without user login, and OAuth1 (3-legged) for full diary logging capabilities, which requires a one-time user authorization.

Installation

To install the FatSecret skill, navigate to your OpenClaw agent's environment and execute the following command:

clawhub install openclaw/skills/skills/f-liva/fatsecret

After installation, you will need to obtain API credentials from the FatSecret platform (https://platform.fatsecret.com) by registering an application. Save your Consumer Key and Consumer Secret in ~/.config/fatsecret/config.json. For diary logging, an additional one-time authorization flow is required via the CLI command scripts/fatsecret-cli.sh auth.

Use Cases

This skill is ideal for users who want to:

• Find nutritional information: Quickly look up calories, fat, protein, carbohydrates, and micronutrients for any food item.
• Search for foods: Discover specific food products or generic food items in a large database.
• Scan barcodes: Identify packaged foods and their nutritional content by scanning their barcodes.
• Search for recipes: Find healthy meal ideas and recipes based on various criteria.
• Log meals: Record breakfast, lunch, dinner, and snacks directly into a personal FatSecret food diary.
• Track diet: Monitor daily intake to manage weight, health goals, or dietary restrictions.

Example Prompts

1. "Find the nutritional information for a medium avocado."
2. "Scan the barcode 078742010351 and tell me its calories."
3. "Log 2 eggs and a slice of toast as breakfast to my diary."

Tips & Limitations

• Authentication is key: For read-only operations (searching, barcode lookup), no user login is needed. However, to log food to a personal diary, you must complete the OAuth1 authentication flow.
• API Key Security: Protect your FatSecret Consumer Key and Secret; do not share them publicly.
• Data Accuracy: While FatSecret has a large database, nutritional information can vary. Always double-check critical data.
• Rate Limits: Be mindful of potential API rate limits imposed by FatSecret.
• Interactive Logging: The log command is interactive and prompts for details, while quick provides a faster, non-interactive logging option for common entries.