Storyblok

{
  "service_type": "platform",
  "base_url": "https://api.storyblok.com",
  "auth_method": "api_key",
  "auth_config": {
    "header": "Authorization",
    "format": "Bearer {token}",
    "public_token_location": "query_param",
    "public_token_param": "token",
    "management_token_type": "personal_access_token"
  },
  "endpoints": [
    {
      "name": "Content Delivery API",
      "base_url": "https://api.storyblok.com/v2/cdn",
      "description": "Read-only API for retrieving published content. Requires a public token (query param 'token'). Supports stories, datasources, tags, links, and more.",
      "docs_url": "https://www.storyblok.com/docs/api/content-delivery"
    },
    {
      "name": "Management API",
      "base_url": "https://mapi.storyblok.com/v1",
      "description": "Full CRUD API for managing spaces, stories, components, assets, users, etc. Requires a personal access token or OAuth token via Authorization Bearer header.",
      "docs_url": "https://www.storyblok.com/docs/api/management"
    },
    {
      "name": "GraphQL API",
      "base_url": "https://gapi-browser.storyblok.com/v1/graphql",
      "description": "GraphQL endpoint for querying content. Uses public token for authentication.",
      "docs_url": "https://www.storyblok.com/docs/api/graphql"
    },
    {
      "name": "Webhooks",
      "description": "Configurable webhooks for events like story published, unpublished, deleted, etc. (configuration via Management API or UI)."
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": true,
      "free_tier_details": "Community plan with limited users, spaces, and features",
      "paid_tiers": "Starter, Growth, and Enterprise plans with increasing limits and features",
      "pricing_url": "https://www.storyblok.com/pricing"
    }
  },
  "rate_limits": {
    "content_delivery_api": "Depends on plan; typically 1,000 requests per minute for higher plans",
    "management_api": "Depends on plan; typically 6 requests per second for free, higher for paid"
  },
  "capabilities": [
    "Headless CMS with visual editor",
    "API-first content management",
    "Multi-channel content delivery",
    "Component-based content modeling",
    "Localization and multi-language support",
    "Versioning and workflow management",
    "Asset management (images, files)",
    "Webhooks and integrations",
    "GraphQL support",
    "App ecosystem and marketplace",
    "Enterprise-grade scalability and security",
    "AI-powered search (via add-on)"
  ],
  "raw_analysis": "Storyblok is a mature, enterprise-grade headless CMS with a strong API-first architecture. It provides both REST and GraphQL APIs for content delivery and a comprehensive Management API for full administrative control. Authentication uses API tokens: public tokens for read-only content delivery and personal access tokens for management operations. The platform offers a generous free tier and scalable paid plans. It is well-suited for developers and marketers building modern web experiences, with extensive documentation, tutorials, and a partner ecosystem. The presence of a visual editor and component-based modeling makes it a compelling alternative to traditional CMSs. Rate limits vary by plan. The service is primarily accessed via its APIs, SDKs, and integrations, with a web-based admin UI."
}

1/3 tests passed

```json
{
  "overall": 68,
  "dimensions": {
    "token_efficiency": 8.5,
    "first_try_success": 7.5,
    "response_parseability": 9.0,
    "error_clarity": 6.5,
    "doc_quality": 8.0,
    "auth_simplicity": 7.0,
    "latency": 9.5,
    "consistency": 7.5
  },
  "pricing_normalized": {
    "model": "freemium",
    "free_tier": true,
    "free_tier_notes": "Community plan with limited users, spaces, and features",
    "paid_tiers": ["Starter", "Growth", "Enterprise"],
    "pricing_url": "https://www.storyblok.com/pricing"
  },
  "issues": [
    "No llms.txt at /llms.txt (404) — agents lack a machine-readable capability summary",
    "No robots.txt at /robots.txt (404) — crawler/agent policy is undefined",
    "Auth complexity: signup likely requires email verification; not a magic-link or agent-native flow",
    "Free tier limits (users/spaces/features) are not specified numerically, requiring doc digging",
    "Pricing tiers not normalized to specific quotas or dollar values in provided data"
  ],
  "recommendations": [
    "Publish llms.txt with a concise capability summary, endpoints, and auth flow for agent consumption",
    "Publish robots.txt declaring crawler policy and sitemap",
    "Provide explicit numeric free-tier limits (users, spaces, API calls) in public docs",
    "Support magic-link or agent-native signup (e.g., verified-identity onboarding) to reduce first-try friction",
    "Surface a quickstart with GraphQL/REST example payloads to maximize parseability for agents",
    "Normalize pricing into structured JSON (tier → limits → price) for programmatic comparisons"
  ]
}
```