anytype_skill

Overview

This skill lets you interact with Anytype via the anytype-cli and its local HTTP API to read, create, update, and search objects/pages inside Anytype spaces. It includes first-time setup steps (account, service, space joining, API key) and reusable patterns for ongoing API usage. The skill bundles a small Python helper and practical notes to avoid common pitfalls when calling endpoints.

How this skill works

The skill calls the Anytype local API at http://127.0.0.1:31012 using an API key passed in the Authorization header. It uses anytype CLI commands for one-time setup and service control, and then issues HTTP requests for listing spaces, searching, creating, and patching objects. A provided Python snippet and scripts/anytype_api.py make it straightforward to load the stored .env key and issue authenticated requests.

When to use it

• Automate creation or updates of pages and objects inside an Anytype space.
• Bulk export, backup, or archive content by listing and fetching objects.
• Search across spaces programmatically to find or index content.
• Set up a bot account or service that interacts with Anytype reliably.
• Integrate Anytype content into other automation or reporting pipelines.

Best practices

• Check anytype auth status and anytype space list before running API calls to ensure the service and account are ready.
• Store the API key in a .env file and load it in scripts to avoid leaking credentials in code.
• Remember create uses the field body while update (patch) uses markdown — avoid mixing them.
• Use space-scoped endpoints when possible (GET /v1/spaces/{space_id}/objects) to limit scope and improve performance.
• Reuse the provided scripts/anytype_api.py helper to standardize requests and error handling.

Example use cases

• Create a daily meeting notes page automatically in a team space each morning.
• Search for all pages mentioning a project name and export them for archival.
• Batch-update a set of pages to add a new tag or modify their markdown content.
• Join an invited workspace, provision a bot account, and rotate API keys as part of onboarding automation.
• List all objects in a space and produce a CSV inventory for reporting or backups.