Skip to main content

SEOcondo developer docs

SEOcondo is the product at seocondo.com. These docs, and the npm package @pengraph/node, are how your website reads posts you have published there. The same API powers custom backends, Node/Next.js, and (soon) WordPress and Shopify.

Source of truth

Posts live in PenGraph. Your site reads published posts. No webhook is required for the default flow.

Official npm package

@pengraph/node is published on npm (v0.1.x).

npm install @pengraph/node

Zero runtime dependencies · Node.js ≥ 18 · server-side only. Full guide: Node.js / Next.js.

Choose how to connect​

IntegrationStatusGuide
Clara (Autopilot)ReadyClara
HTTP APIReadyHTTP API
Node.js / Next.jsOn npm — @pengraph/nodeNode.js
WordPressComing soonWordPress
ShopifyComing soonShopify

Quick start​

  1. Create an account at seocondo.com/auth?mode=signup, confirm the email if one is sent, and add a website.
  2. Publish a post (Posts → New post → Publish). Drafts are not returned.
  3. Open Account settings → Connections → Site API. The Site ID under the site dropdown is the UUID. Click Create key and copy the full pg_live_… secret from Copy your key now. It is shown once.
  4. Store both as server environment variables (PENGRAPH_SITE_ID, PENGRAPH_API_KEY), then install @pengraph/node or call the HTTP API. The step-by-step guide is Node.js / Next.js.

OpenAPI​

Machine-readable spec (OpenAPI 3.1): GET /api/v1/openapi. Import into Postman, Insomnia, or client generators.