Skip to content

chore(seo): retitle Python framework integration guides#568

Merged
amavashev merged 1 commit into
mainfrom
chore/python-seo-how-to-titles
May 6, 2026
Merged

chore(seo): retitle Python framework integration guides#568
amavashev merged 1 commit into
mainfrom
chore/python-seo-how-to-titles

Conversation

@amavashev
Copy link
Copy Markdown
Contributor

Summary

Phase 1.4 of the Python-gap closing plan. Retitles the five Python framework integration how-tos to lead with category-search terms (budget control, cost enforcement, cost governance) instead of the brand-led "Integrating Cycles with X" pattern.

Why

The Python adoption side is lagging TypeScript materially (PyPI flat for ~6 weeks pre-source-change; cycles-client-python 157 unique cloners vs. cycles-client-typescript 288). The diagnostic (traffic signal interpretation memory — internal) found the biggest sub-gap is discovery — Cycles doesn't rank for natural Python search queries while named competitors (AgentBudget, AgentGuard, agent-cost-guardrails) do. Brand-led titles were a contributor.

Changes (frontmatter title + H1 + description on each)

File New title
integrating-cycles-with-langchain.md LangChain Budget Control via Callback Handlers (Python)
integrating-cycles-with-langgraph.md LangGraph Budget Control: Per-Node Cost Enforcement
integrating-cycles-with-crewai.md CrewAI Budget Control: Multi-Agent Cost Enforcement
integrating-cycles-with-autogen.md AutoGen Budget Control: Cost Governance for Microsoft AutoGen
integrating-cycles-with-openai-agents.md OpenAI Agents SDK Budget Control (Python)

What this doesn't change

  • URL slugs (filenames) are unchanged — external links and search-engine indexes preserved.
  • Inbound anchor links from other posts target subheadings (#the-callback-handler-approach, #prerequisites), not the H1 — verified safe.
  • Body content is unchanged in this PR. Optional: tighten descriptions / leading paragraphs in a follow-up if needed.
  • The OpenClaw / MCP / non-Python integration guides keep the "Integrating Cycles with X" pattern. Only Python-side titles change here, since that's where the discovery gap is.

Phase 1 status (rest of the plan)

  • 1.1 SDK streaming gap — No gap. cycles-client-python has a full streaming.py module; it's just missing from the README. Follow-up: add a "Streaming" section to cycles-client-python README.
  • 1.2 PyPI metadata — pending. Diff prepared; needs to be applied in cycles-client-python repo.
  • 1.3 GitHub topics — pending. Needs admin access to the relevant repos.
  • 1.4 How-to title rewrites — this PR.

Test plan

  • npm run dev, navigate to /how-to/, confirm sidebar labels reflect new titles.
  • Visit each of the 5 retitled pages, confirm the page renders with the new H1 and the in-page links still work.
  • Verify the two inbound anchors still resolve: /how-to/integrating-cycles-with-langchain#the-callback-handler-approach (referenced from langgraph guide) and /how-to/integrating-cycles-with-openai-agents#prerequisites (referenced from openai-agents-sdk-has-guardrails blog post).

…keyword targeting

Rewrites the H1 + frontmatter title + description on the five Python
framework integration how-tos to lead with the category-search terms
(budget control, cost enforcement, cost governance) instead of the
brand-led "Integrating Cycles with X" pattern.

Motivation: the Python adoption side is lagging TypeScript by a wide
margin (PyPI flat for 6+ weeks; cycles-client-python at 157 unique
cloners vs. cycles-client-typescript at 288). Diagnostic showed the
biggest sub-gap is discovery — Cycles doesn't rank for natural Python
search queries while named competitors (AgentBudget, AgentGuard,
agent-cost-guardrails) do. The brand-led titles were a contributor.

Changes:
- LangChain: "Integrating Cycles with LangChain" →
  "LangChain Budget Control via Callback Handlers (Python)"
- LangGraph: "Integrating Cycles with LangGraph" →
  "LangGraph Budget Control: Per-Node Cost Enforcement"
- CrewAI: "Integrating Cycles with CrewAI" →
  "CrewAI Budget Control: Multi-Agent Cost Enforcement"
- AutoGen: "Integrating Cycles with AutoGen" →
  "AutoGen Budget Control: Cost Governance for Microsoft AutoGen"
- OpenAI Agents SDK: "Integrating Cycles with OpenAI Agents SDK" →
  "OpenAI Agents SDK Budget Control (Python)"

Inbound anchor references both point at subheadings, not the H1, so
no internal-link breakage. URL slugs (filenames) unchanged — existing
external links and search-engine indexes preserved.

Part of Phase 1 of the Python-gap closing plan. Phase 1 also includes
PyPI metadata + GitHub topics updates on cycles-client-python (separate
repo, separate PR proposed).
@amavashev amavashev enabled auto-merge May 6, 2026 18:02
@amavashev amavashev merged commit 55f8881 into main May 6, 2026
5 checks passed
@amavashev amavashev deleted the chore/python-seo-how-to-titles branch May 6, 2026 18:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant