Skip to content

docs: restructure integrations to mirror LP categories and add tier ranking#2506

Draft
marcel-rbro wants to merge 3 commits intomasterfrom
docs/integrations-restructure-tiers
Draft

docs: restructure integrations to mirror LP categories and add tier ranking#2506
marcel-rbro wants to merge 3 commits intomasterfrom
docs/integrations-restructure-tiers

Conversation

@marcel-rbro
Copy link
Copy Markdown
Contributor

Closes #2505

Summary

  • Reorganize sources/platform/integrations/ into folders that mirror apify.com/integrations.
  • Move MCP server into Built-in integrations (was under ai/mcp/).
  • Encode tier in sidebar_position: 1 = S-tier, 2 = Mid, 3 = Other. Within a tier, items order alphabetically.
  • All page slugs are unchanged, so no URLs change and no redirects are required.

Tier ranking

Source: prioritization input from Lukas Bekr.

  • S-tier (1) — built-in (API, Actors, Webhooks, MCP), n8n, Make, Zapier, OpenClaw, Gumloop, Google ADK, LangChain, OpenAI Agents SDK, Vercel AI SDK, Airtable, Snowflake, Manus, x402, Pinecone, GitHub
  • Mid (2) — Dify, Workato, Windmill, Bubble, IFTTT, Lindy, Amazon Bedrock, CrewAI, Keboola, Gmail, Telegram, Slack, Upsonic
  • Other (3) — everything else

New folder structure

Folder LP category Notes
built-in/ Built-in platform integrations API, Actors, Webhooks, MCP
workflow-automation/ Workflow automation renamed from workflows-and-notifications/
ai-assistants/ AI assistants new
ai-sdks-frameworks/ AI SDKs & frameworks split from old ai/
collaboration/ Collaboration Gmail, Slack, Drive
data-pipelines/ ELT & data pipelines renamed from data-storage/
vector-db-storage/ Vector DB & storage new
developer-tools/ Developer tools GitHub
payments/ Payments x402, Skyfire
other/ (catch-all) Bubble, Dify, Telegram

LP categories without docs (Coding agents & IDEs, App builders, GTM tools, MCP gateways, iPaaS, Productivity) are out of scope here - tracked in the issue for follow-up.

Implementation notes

  • File moves use git mv to retain history.
  • Outside-of-integrations relative links updated: sources/platform/storage/{dataset,key_value_store,request_queue}.md, sources/platform/actors/development/{actor_definition,permissions}/index.md, sources/platform/actors/development/index.md, sources/platform/actors/running/actor_standby.md.
  • index.mdx rewritten to mirror the LP and to surface S-tier first within each section.
  • pnpm build passes locally; no new broken-link errors.

Test plan

  • Local preview: confirm sidebar groupings and order match the tier ranking
  • Spot-check key URLs still resolve: /platform/integrations/api, /integrations/mcp, /integrations/n8n, /integrations/github, /integrations/airtable
  • Confirm MCP card now shows under Built-in integrations on the index page
  • Verify no 404s in the sitemap diff vs master

🤖 Generated with Claude Code

…ranking

Reorganize sources/platform/integrations/ so that folders mirror the
categories on apify.com/integrations and each integration's
sidebar_position encodes a tier (1 = S, 2 = Mid, 3 = Other). MCP moves
into Built-in alongside API, Actors, and Webhooks.

Slugs are unchanged, so no URLs change and no redirects are required.

Refs #2505
@github-actions github-actions Bot added the t-docs Issues owned by technical writing team. label May 6, 2026
Rename eight markdown files to use hyphens instead of underscores so
filename style matches existing slug conventions:

- integrate_with_apify.md
- ai-sdks-frameworks/aws_bedrock.md
- ai-sdks-frameworks/openai_agents.md
- ai-sdks-frameworks/openai_assistants.md
- vector-db-storage/airtable/console_integration.md
- built-in/actors/integration_ready_actors.md
- built-in/actors/integrating_actors_via_api.md
- built-in/webhooks/ad_hoc_webhooks.md

URL change: /integrations/aws_bedrock -> /integrations/aws-bedrock
(only slug that previously contained an underscore). Add a redirect
upstream if needed.

Refs #2505
@marcel-rbro marcel-rbro changed the title docs(integrations): restructure to mirror LP categories and add tier ranking docs: restructure integrations to mirror LP categories and add tier ranking May 7, 2026
Promote GitHub to a Built-in integration alongside API, Actors, Webhooks,
and MCP. Drop the now-empty Developer tools category. Slug `/integrations/github`
is unchanged, so no redirects are required.

Also fix broken markdown links left over from the underscore-to-hyphen
filename rename: `integrate_with_apify.md` and `integration_ready_actors.md`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-docs Issues owned by technical writing team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Restructure integrations docs to mirror apify.com/integrations and add tier ranking

2 participants