@egbe-ai/opencode 0.0.0-stage → 0.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +4 -0
- package/README.md +124 -2
- package/index.js +5 -0
- package/package.json +55 -4
- package/plugin.js +230 -0
- package/session-log.js +315 -0
- package/skills/.egbe-catalog/manifest.json +1 -0
- package/skills/egbe-os-analytics/SKILL.md +499 -0
- package/skills/egbe-os-analytics/canonical-events.v1.json +256 -0
- package/skills/egbe-os-analytics/references/session-funnel.md +130 -0
- package/skills/egbe-os-analytics/references/workflows/activation-tracking.md +147 -0
- package/skills/egbe-os-analytics/references/workflows/landing-click-tracking.md +209 -0
- package/skills/egbe-os-analytics/references/workflows/payment-lifecycle-tracking.md +122 -0
- package/skills/egbe-os-analytics/references/workflows/product-funnel-tracking.md +77 -0
- package/skills/egbe-os-analytics/references/workflows/signup-lifecycle-tracking.md +208 -0
- package/skills/egbe-os-analytics/scripts/umami_funnel.py +927 -0
- package/skills/egbe-os-apollo-lead-finder/SKILL.md +135 -0
- package/skills/egbe-os-apollo-lead-finder/references/operations.md +240 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/apollo-client.js +343 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/helpers.js +127 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/places-filters.js +217 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/sourcing.js +153 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.js +653 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.sh +4 -0
- package/skills/egbe-os-campaign-landing-page/SKILL.md +95 -0
- package/skills/egbe-os-campaign-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-campaign-landing-page/references/leads-calendar-and-tracking.md +66 -0
- package/skills/egbe-os-campaign-landing-page/references/os-wiring.md +58 -0
- package/skills/egbe-os-campaign-landing-page/references/qa.md +40 -0
- package/skills/egbe-os-campaign-landing-page/references/routing.md +32 -0
- package/skills/egbe-os-db/SKILL.md +174 -0
- package/skills/egbe-os-deploy/SKILL.md +412 -0
- package/skills/egbe-os-design/SKILL.md +182 -0
- package/skills/egbe-os-design-landing-page/SKILL.md +117 -0
- package/skills/egbe-os-design-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/.dockerignore +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/AGENTS.md +31 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/Dockerfile +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/eslint.config.mjs +18 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/next.config.ts +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/package.json +36 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/postcss.config.mjs +7 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/public/.gitkeep +1 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.edge.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.server.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/global-error.tsx +19 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/globals.css +22 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/layout.tsx +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/page.tsx +3 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/privacy/page.tsx +28 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/components/egbe-analytics.tsx +39 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation-client.ts +15 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/egbe-observability.generated.ts +20 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/utils.ts +6 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/tsconfig.json +34 -0
- package/skills/egbe-os-design-landing-page/references/application-preparation.md +44 -0
- package/skills/egbe-os-design-landing-page/references/page-inputs.md +22 -0
- package/skills/egbe-os-destination-readiness/SKILL.md +132 -0
- package/skills/egbe-os-destination-readiness/references/checks.md +130 -0
- package/skills/egbe-os-destination-readiness/references/network-requirements.md +34 -0
- package/skills/egbe-os-destination-readiness/references/report.md +116 -0
- package/skills/egbe-os-domains/SKILL.md +189 -0
- package/skills/egbe-os-errors/SKILL.md +259 -0
- package/skills/egbe-os-git/SKILL.md +275 -0
- package/skills/egbe-os-git/references/issues.md +33 -0
- package/skills/egbe-os-google-ads/SKILL.md +163 -0
- package/skills/egbe-os-google-ads/references/artifacts.md +133 -0
- package/skills/egbe-os-google-ads/references/campaigns.md +157 -0
- package/skills/egbe-os-google-ads/references/conversions.md +153 -0
- package/skills/egbe-os-google-ads/references/delivery.md +128 -0
- package/skills/egbe-os-google-ads/references/keyword-ideas.md +40 -0
- package/skills/egbe-os-google-ads/references/reporting.md +105 -0
- package/skills/egbe-os-google-ads/references/search-assets.md +219 -0
- package/skills/egbe-os-google-ads/references/server-conversions.md +119 -0
- package/skills/egbe-os-google-auth/SKILL.md +285 -0
- package/skills/egbe-os-google-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-gtm-knowledge/SKILL.md +151 -0
- package/skills/egbe-os-images/SKILL.md +163 -0
- package/skills/egbe-os-images/references/stock-images.md +21 -0
- package/skills/egbe-os-instantly-campaign-launcher/SKILL.md +127 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/instantly-ops.md +260 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/observation-and-scheduling.md +188 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/reply-handling.md +116 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-spec-template.json +65 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-state.md +145 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/conclude-campaign.js +158 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/install-crons.js +956 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/launch-campaign.js +2008 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/campaign-metrics.js +124 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/confirmed-opt-outs.js +208 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/create-once.js +23 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/gtm-identity.js +125 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/helpers.js +545 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/html-body.js +266 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/instantly-client.js +328 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/outreach-db.js +370 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/recipient-exclusion/index.js +86 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/replenish-test-harness.js +53 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/reply-queue.js +67 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/run-config.js +103 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/sender-selection.js +105 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/monitor-campaign.js +607 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/outreach-report.js +147 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/replenish-leads.js +619 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/reply-worker.js +258 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/run-cron-job.js +32 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/send-reply.js +260 -0
- package/skills/egbe-os-linkedin-ads/SKILL.md +114 -0
- package/skills/egbe-os-linkedin-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/api-reference.md +154 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/artifacts.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/build-paused.md +44 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/conversions.md +88 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/launch-and-pause.md +49 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/monitoring.md +35 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/readiness.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/targeting-and-creative.md +52 -0
- package/skills/egbe-os-llm/SKILL.md +160 -0
- package/skills/egbe-os-mail/SKILL.md +180 -0
- package/skills/egbe-os-me/SKILL.md +119 -0
- package/skills/egbe-os-meta-ads/SKILL.md +114 -0
- package/skills/egbe-os-meta-ads/references/creative/creative-specs.md +15 -0
- package/skills/egbe-os-meta-ads/references/creative/talking-head.md +35 -0
- package/skills/egbe-os-meta-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-meta-ads/references/runtime/api-reference.md +436 -0
- package/skills/egbe-os-meta-ads/references/runtime/artifacts.md +51 -0
- package/skills/egbe-os-meta-ads/references/runtime/insights-reference.md +187 -0
- package/skills/egbe-os-meta-ads/references/runtime/pixel-install.md +196 -0
- package/skills/egbe-os-meta-ads/references/runtime/shared-analytics-attribution.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/build-paused.md +36 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch-ready.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch.md +23 -0
- package/skills/egbe-os-meta-ads/references/workflows/monitoring.md +72 -0
- package/skills/egbe-os-meta-ads/references/workflows/pause.md +17 -0
- package/skills/egbe-os-meta-ads/references/workflows/recovery.md +23 -0
- package/skills/egbe-os-meta-ads/scripts/check-pixel.py +229 -0
- package/skills/egbe-os-meta-ads/scripts/validate-meta-artifacts.py +187 -0
- package/skills/egbe-os-notifications/SKILL.md +78 -0
- package/skills/egbe-os-openai-ads/SKILL.md +149 -0
- package/skills/egbe-os-openai-ads/references/creative/chat-card.md +51 -0
- package/skills/egbe-os-openai-ads/references/destination-requirements.md +29 -0
- package/skills/egbe-os-openai-ads/references/runtime/api-reference.md +219 -0
- package/skills/egbe-os-openai-ads/references/runtime/artifacts.md +169 -0
- package/skills/egbe-os-openai-ads/references/workflows/build-paused.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/conversions.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/creative-assembly.md +24 -0
- package/skills/egbe-os-openai-ads/references/workflows/launch.md +27 -0
- package/skills/egbe-os-openai-ads/references/workflows/monitoring.md +54 -0
- package/skills/egbe-os-openai-ads/references/workflows/pause.md +22 -0
- package/skills/egbe-os-openai-ads/references/workflows/readiness.md +37 -0
- package/skills/egbe-os-openai-ads/references/workflows/tracking.md +32 -0
- package/skills/egbe-os-openai-ads/scripts/validate-openai-artifacts.py +271 -0
- package/skills/egbe-os-organic-trend-watch/SKILL.md +139 -0
- package/skills/egbe-os-organic-trend-watch/agents/openai.yaml +4 -0
- package/skills/egbe-os-organic-trend-watch/references/analysis-and-adaptation.md +54 -0
- package/skills/egbe-os-organic-trend-watch/references/collection-and-analysis.md +117 -0
- package/skills/egbe-os-organic-trend-watch/references/output-contract.md +133 -0
- package/skills/egbe-os-organic-trend-watch/references/provider-contract.md +169 -0
- package/skills/egbe-os-organic-trend-watch/references/runtime-contract.md +204 -0
- package/skills/egbe-os-organic-trend-watch/references/visual-analysis-prompt.md +17 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_analysis.py +612 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_contract.py +1133 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_provider_inputs.py +165 -0
- package/skills/egbe-os-organic-trend-watch/scripts/analyze-visual-evidence.py +315 -0
- package/skills/egbe-os-organic-trend-watch/scripts/build-provider-inputs.py +88 -0
- package/skills/egbe-os-organic-trend-watch/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-organic-trend-watch/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-organic-trend-watch/scripts/finalize-receipt.py +106 -0
- package/skills/egbe-os-organic-trend-watch/scripts/normalize-videos.py +647 -0
- package/skills/egbe-os-organic-trend-watch/scripts/prepare-visual-evidence.py +324 -0
- package/skills/egbe-os-organic-trend-watch/scripts/render-result.py +30 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-apify.py +723 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-state.py +192 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-context.py +27 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-runtime.py +137 -0
- package/skills/egbe-os-payments/SKILL.md +215 -0
- package/skills/egbe-os-payments/agents/openai.yaml +4 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/.egbe/scaffolds/billing-nextjs-subscription.v1.json +5 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/AGENTS.append.md +13 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/db/migrations/1000_egbe_billing.sql +66 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/package.fragment.json +12 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/scripts/billing-sync.mjs +162 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/error.tsx +11 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/loading.tsx +8 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/page.tsx +121 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/checkout/route.ts +102 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/portal/route.ts +54 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/status/route.ts +22 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/payments/webhook/route.ts +65 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/components/egbe-billing/plan-badge.tsx +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/billing-sync.test.mjs +58 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/catalog.ts +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/checkout-payload.ts +47 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/foundation-contract.test.mjs +59 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.d.ts +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.mjs +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.test.mjs +94 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/os-client.ts +96 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/plans.json +17 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/repository.ts +325 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.d.ts +6 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.mjs +22 -0
- package/skills/egbe-os-payments/references/contracts/plan-catalog.md +46 -0
- package/skills/egbe-os-payments/references/security/durable-verification.md +64 -0
- package/skills/egbe-os-payments/references/security/server-integration.md +26 -0
- package/skills/egbe-os-payments/references/security/webhook-and-entitlements.md +152 -0
- package/skills/egbe-os-payments/references/ux/billing-experience.md +47 -0
- package/skills/egbe-os-payments/references/workflows/account-billing.md +64 -0
- package/skills/egbe-os-payments/references/workflows/discounts-and-promotion-codes.md +265 -0
- package/skills/egbe-os-payments/references/workflows/one-time-purchase.md +75 -0
- package/skills/egbe-os-payments/references/workflows/product-checkout.md +355 -0
- package/skills/egbe-os-payments/references/workflows/subscription-lifecycle.md +55 -0
- package/skills/egbe-os-playbook/SKILL.md +79 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/email-outreach.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/google-search.md +40 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/linkedin.md +24 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/meta.md +23 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/openai.md +15 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/reddit.md +56 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/choose-test.md +73 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/evaluate.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/market.md +96 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/run-test.md +111 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition.md +56 -0
- package/skills/egbe-os-playbook/playbooks/product/business-loop.md +141 -0
- package/skills/egbe-os-playbook/playbooks/product/collaboration.md +26 -0
- package/skills/egbe-os-playbook/playbooks/product/deliver.md +75 -0
- package/skills/egbe-os-playbook/playbooks/product/diagnose.md +80 -0
- package/skills/egbe-os-playbook/playbooks/product/evaluate.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/experience.md +132 -0
- package/skills/egbe-os-playbook/playbooks/product/loop-examples.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/offer.md +65 -0
- package/skills/egbe-os-playbook/playbooks/product/value.md +91 -0
- package/skills/egbe-os-playbook/playbooks/product.md +67 -0
- package/skills/egbe-os-playbook/references/catalog.md +127 -0
- package/skills/egbe-os-playbook/references/changes.md +167 -0
- package/skills/egbe-os-playbook/scripts/playbook-changes.py +6 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/__init__.py +1 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/cli.py +57 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/operations.py +137 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/protocol.py +132 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/storage.py +180 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/transport.py +113 -0
- package/skills/egbe-os-product-auth/SKILL.md +151 -0
- package/skills/egbe-os-product-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-auth/assets/db/README.md +102 -0
- package/skills/egbe-os-product-auth/assets/db/create-validation-session.mjs +223 -0
- package/skills/egbe-os-product-auth/assets/db/migrate.mjs +64 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0001_auth.sql +33 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0002_auth_identities.sql +16 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/AGENTS.append.md +17 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/package.fragment.json +10 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/AGENTS.append.md +9 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/package.fragment.json +13 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/db.ts +31 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/identity.ts +94 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/index.ts +3 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/session.ts +91 -0
- package/skills/egbe-os-product-auth/references/contracts/live-auth-interface.md +108 -0
- package/skills/egbe-os-product-auth/references/frameworks/nextjs.md +34 -0
- package/skills/egbe-os-product-auth/references/security/session-and-credentials.md +73 -0
- package/skills/egbe-os-product-auth/references/ux/auth-experience.md +58 -0
- package/skills/egbe-os-product-auth/references/workflows/account-recovery.md +22 -0
- package/skills/egbe-os-product-auth/references/workflows/build-auth.md +212 -0
- package/skills/egbe-os-product-auth/references/workflows/google.md +34 -0
- package/skills/egbe-os-product-auth/references/workflows/passwordless-email.md +65 -0
- package/skills/egbe-os-product-build/SKILL.md +111 -0
- package/skills/egbe-os-product-build/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-build/references/capabilities.md +25 -0
- package/skills/egbe-os-product-build/references/engineering.md +72 -0
- package/skills/egbe-os-product-build/references/execution.md +55 -0
- package/skills/egbe-os-product-build/references/foundations.md +93 -0
- package/skills/egbe-os-product-build/references/interface-quality.md +32 -0
- package/skills/egbe-os-product-build/references/workflows/private-review-handoff.md +86 -0
- package/skills/egbe-os-product-build/scripts/scaffold.py +296 -0
- package/skills/egbe-os-product-demo-video/SKILL.md +118 -0
- package/skills/egbe-os-product-demo-video/references/recording.md +32 -0
- package/skills/egbe-os-product-market-research/SKILL.md +159 -0
- package/skills/egbe-os-product-market-research/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-market-research/references/catalog.v1.json +177 -0
- package/skills/egbe-os-product-market-research/references/config/channel-footprint-sources.v1.json +99 -0
- package/skills/egbe-os-product-market-research/references/config/creative-taxonomy.v1.json +367 -0
- package/skills/egbe-os-product-market-research/references/contracts/creative-video.md +75 -0
- package/skills/egbe-os-product-market-research/references/contracts/funnel-teardown.md +235 -0
- package/skills/egbe-os-product-market-research/references/contracts/geography-comparison.md +71 -0
- package/skills/egbe-os-product-market-research/references/contracts/lifecycle-capture.md +119 -0
- package/skills/egbe-os-product-market-research/references/contracts/research-artifacts.md +520 -0
- package/skills/egbe-os-product-market-research/references/contracts/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.md +137 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.md +118 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.md +154 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.md +100 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.md +126 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.md +98 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.md +217 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.md +113 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/workflows/acquisition-channels.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/channel-footprint.md +163 -0
- package/skills/egbe-os-product-market-research/references/workflows/community-demand.md +100 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitive-landscape.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-ads.md +82 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-set.md +300 -0
- package/skills/egbe-os-product-market-research/references/workflows/creative-patterns.md +228 -0
- package/skills/egbe-os-product-market-research/references/workflows/demand-validation.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/fleet-prior.md +80 -0
- package/skills/egbe-os-product-market-research/references/workflows/funnel-teardown.md +184 -0
- package/skills/egbe-os-product-market-research/references/workflows/geography-comparison.md +84 -0
- package/skills/egbe-os-product-market-research/references/workflows/keyword-economics.md +122 -0
- package/skills/egbe-os-product-market-research/references/workflows/lifecycle-capture.md +218 -0
- package/skills/egbe-os-product-market-research/references/workflows/local-research.md +55 -0
- package/skills/egbe-os-product-market-research/references/workflows/market-size-and-dynamics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/preview.md +175 -0
- package/skills/egbe-os-product-market-research/references/workflows/pricing-and-monetization.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/recommendations.md +35 -0
- package/skills/egbe-os-product-market-research/references/workflows/review-mining.md +76 -0
- package/skills/egbe-os-product-market-research/references/workflows/target-audience.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/tiktok-reels-market-trends.md +46 -0
- package/skills/egbe-os-product-market-research/references/workflows/unit-economics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/value-proposition.md +27 -0
- package/skills/egbe-os-product-market-research/scripts/build-organic-trend-context.py +167 -0
- package/skills/egbe-os-product-market-research/scripts/build-preview-context.py +91 -0
- package/skills/egbe-os-product-market-research/scripts/build-research-query.py +225 -0
- package/skills/egbe-os-product-market-research/scripts/channel-footprint-model.py +294 -0
- package/skills/egbe-os-product-market-research/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-product-market-research/scripts/creative-model.py +364 -0
- package/skills/egbe-os-product-market-research/scripts/creative-selection.py +113 -0
- package/skills/egbe-os-product-market-research/scripts/creative-semantics.py +365 -0
- package/skills/egbe-os-product-market-research/scripts/creative-video.py +542 -0
- package/skills/egbe-os-product-market-research/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-product-market-research/scripts/finalize-organic-trend-watch.py +304 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-email-review.py +97 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-model.py +966 -0
- package/skills/egbe-os-product-market-research/scripts/funnel_features.py +50 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison-contract.py +172 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison.py +169 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-forecast.py +61 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-locale-publication.py +136 -0
- package/skills/egbe-os-product-market-research/scripts/lifecycle-start.py +190 -0
- package/skills/egbe-os-product-market-research/scripts/persist-research-report.py +63 -0
- package/skills/egbe-os-product-market-research/scripts/research-artifact-io.py +281 -0
- package/skills/egbe-os-product-market-research/scripts/research-evidence.py +496 -0
- package/skills/egbe-os-product-market-research/scripts/research-policy.py +33 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-runtime.py +343 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-workflow.py +288 -0
- package/skills/egbe-os-product-market-research/scripts/research_integrity.py +122 -0
- package/skills/egbe-os-product-market-research/scripts/review-research-completion.py +306 -0
- package/skills/egbe-os-product-market-research/scripts/run-acquisition-channels.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-channel-footprint.py +2258 -0
- package/skills/egbe-os-product-market-research/scripts/run-community-demand.py +1603 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitive-landscape.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-ads.py +1156 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-set.py +2514 -0
- package/skills/egbe-os-product-market-research/scripts/run-creative-patterns.py +2042 -0
- package/skills/egbe-os-product-market-research/scripts/run-demand-validation.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-fleet-prior.py +652 -0
- package/skills/egbe-os-product-market-research/scripts/run-funnel-teardown.py +493 -0
- package/skills/egbe-os-product-market-research/scripts/run-keyword-economics.py +1443 -0
- package/skills/egbe-os-product-market-research/scripts/run-lifecycle-capture.py +1543 -0
- package/skills/egbe-os-product-market-research/scripts/run-market-size-and-dynamics.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-os-research.py +311 -0
- package/skills/egbe-os-product-market-research/scripts/run-pricing-and-monetization.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-review-mining.py +1051 -0
- package/skills/egbe-os-product-market-research/scripts/run-target-audience.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-unit-economics.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-value-proposition.py +67 -0
- package/skills/egbe-os-product-market-research/scripts/upsert-markdown-section.py +156 -0
- package/skills/egbe-os-product-market-research/scripts/walk-funnels.py +249 -0
- package/skills/egbe-os-product-market-research/scripts/write-preview.py +710 -0
- package/skills/egbe-os-product-market-research/scripts/write-recommendations.py +272 -0
- package/skills/egbe-os-product-report/SKILL.md +150 -0
- package/skills/egbe-os-product-report/references/artifacts.md +84 -0
- package/skills/egbe-os-product-report/references/brief.md +34 -0
- package/skills/egbe-os-product-report/references/daily.md +76 -0
- package/skills/egbe-os-product-report/references/sources.md +68 -0
- package/skills/egbe-os-product-routines/SKILL.md +166 -0
- package/skills/egbe-os-product-routines/references/catalog.md +22 -0
- package/skills/egbe-os-product-routines/references/continuation-check.md +41 -0
- package/skills/egbe-os-product-routines/references/product-reporting.md +163 -0
- package/skills/egbe-os-product-routines/references/run-preset.md +32 -0
- package/skills/egbe-os-quickstart/scripts/egbe-curl.py +357 -0
- package/skills/egbe-os-quiz-funnel/SKILL.md +152 -0
- package/skills/egbe-os-quiz-funnel/agents/openai.yaml +4 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.d.mts +224 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.mjs +652 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.test.mjs +764 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.d.mts +31 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.mjs +87 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.test.mjs +265 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-reference.test.mjs +254 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/QUIZ.md +195 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json +421 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json +369 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/validation.json +21 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/index.html +26 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-bootstrap.js +31 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-early-actions.mjs +11 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-first-screen.mjs +32 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-page.mjs +480 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz.css +264 -0
- package/skills/egbe-os-quiz-funnel/references/competitor-teardown.md +159 -0
- package/skills/egbe-os-quiz-funnel/references/conversion-handoff.md +156 -0
- package/skills/egbe-os-quiz-funnel/references/implementation.md +207 -0
- package/skills/egbe-os-quiz-funnel/references/inputs.md +37 -0
- package/skills/egbe-os-quiz-funnel/references/measurement.md +122 -0
- package/skills/egbe-os-quiz-funnel/references/spec-contract.md +335 -0
- package/skills/egbe-os-quiz-funnel/references/verification.md +101 -0
- package/skills/egbe-os-quiz-funnel/references/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-quiz-funnel/scripts/compile-quiz-spec.py +1869 -0
- package/skills/egbe-os-quiz-funnel/scripts/prepare-research-identity.py +66 -0
- package/skills/egbe-os-reddit-ads/SKILL.md +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/schema.json +41 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/template.html +106 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/schema.json +61 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/template.html +151 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/schema.json +91 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/template.html +185 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/schema.json +51 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/template.html +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/schema.json +87 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/template.html +212 -0
- package/skills/egbe-os-reddit-ads/references/creative/html-to-png-pipeline.md +123 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-qa.md +12 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-system.md +16 -0
- package/skills/egbe-os-reddit-ads/references/destination-requirements.md +36 -0
- package/skills/egbe-os-reddit-ads/references/runtime/api-reference.md +435 -0
- package/skills/egbe-os-reddit-ads/references/runtime/artifacts.md +57 -0
- package/skills/egbe-os-reddit-ads/references/runtime/monitoring.md +64 -0
- package/skills/egbe-os-reddit-ads/references/runtime/pixel-and-tracking.md +49 -0
- package/skills/egbe-os-reddit-ads/references/runtime/policies.md +19 -0
- package/skills/egbe-os-reddit-ads/references/runtime/shared-analytics-attribution.md +14 -0
- package/skills/egbe-os-reddit-ads/references/workflows/build-paused.md +35 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch-ready.md +19 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch.md +32 -0
- package/skills/egbe-os-reddit-ads/references/workflows/readiness.md +9 -0
- package/skills/egbe-os-reddit-ads/scripts/capture-ad.sh +178 -0
- package/skills/egbe-os-reddit-ads/scripts/validate-reddit-artifacts.py +187 -0
- package/skills/egbe-os-report-ui/SKILL.md +133 -0
- package/skills/egbe-os-report-ui/assets/egbe-wordmark.svg +9 -0
- package/skills/egbe-os-report-ui/assets/examples/components.html +417 -0
- package/skills/egbe-os-report-ui/assets/examples/editorial.html +209 -0
- package/skills/egbe-os-report-ui/assets/scaffold.html +179 -0
- package/skills/egbe-os-report-ui/references/components.md +209 -0
- package/skills/egbe-os-research/SKILL.md +125 -0
- package/skills/egbe-os-saas-unit-economics/SKILL.md +188 -0
- package/skills/egbe-os-scrape/SKILL.md +160 -0
- package/skills/egbe-os-search/SKILL.md +182 -0
- package/skills/egbe-os-search/references/google-places.md +81 -0
- package/skills/egbe-os-support/SKILL.md +149 -0
- package/skills/egbe-os-telemetry/SKILL.md +344 -0
- package/skills/egbe-os-telemetry/references/harnesses/claude-code.md +97 -0
- package/skills/egbe-os-telemetry/references/harnesses/codex.md +22 -0
- package/skills/egbe-os-telemetry/references/harnesses/hermes.md +39 -0
- package/skills/egbe-os-telemetry/references/harnesses/openclaw.md +139 -0
- package/skills/egbe-os-telemetry/references/harnesses/opencode.md +28 -0
- package/skills/egbe-os-tools/SKILL.md +180 -0
- package/skills/egbe-os-tools/references/theona.md +26 -0
- package/skills/egbe-os-wallet/SKILL.md +181 -0
- package/skills/egbe-setup/EGBE.md +484 -0
- package/skills/egbe-setup/SKILL.md +116 -0
- package/skills/egbe-setup/references/project.md +80 -0
- package/state.js +37 -0
- package/update.js +361 -0
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-research
|
|
3
|
+
description: Run and resume deep multi-source research.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when a question needs in-depth evidence or a research job needs continuation."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Deep research"
|
|
8
|
+
egbe-description: "Investigate a question across multiple sources and get a structured report with supporting evidence."
|
|
9
|
+
egbe-category: "AI & data"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
13
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
14
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
15
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
16
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
17
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
18
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
19
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
20
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
21
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
22
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
23
|
+
`path` and `business`, and that `continuation`.
|
|
24
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
25
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
26
|
+
|
|
27
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
28
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
29
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
30
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
31
|
+
set-up project workspace. In a persistent
|
|
32
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
33
|
+
project setup describes.
|
|
34
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
35
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
36
|
+
|
|
37
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
38
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
39
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
40
|
+
saying Egbe is unavailable.
|
|
41
|
+
|
|
42
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
43
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
44
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
45
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
46
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
47
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
48
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
49
|
+
with an agent on their own computer. Code can also be published without the
|
|
50
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
51
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
52
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
53
|
+
deployment.
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
# Deep research
|
|
57
|
+
|
|
58
|
+
Use this capability when a task needs a cited, multi-source web research report.
|
|
59
|
+
OS owns the engine and model routing; callers provide the research question and
|
|
60
|
+
instructions, never a provider or model.
|
|
61
|
+
|
|
62
|
+
Research is asynchronous. Submit once with a stable idempotency key, persist the
|
|
63
|
+
returned job ID, and poll that job until it reaches a terminal state.
|
|
64
|
+
|
|
65
|
+
Authenticate with `Authorization: Bearer $OS_API_KEY`. Base URL: `$OS_URL`
|
|
66
|
+
(`https://os.hz.egbe.dev`).
|
|
67
|
+
|
|
68
|
+
## Submit or recover a job
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/research" -s -X POST \
|
|
72
|
+
-H 'Content-Type: application/json' \
|
|
73
|
+
-d '{
|
|
74
|
+
"query": "Market demand and competitors for AI tutoring apps for European teens in 2026",
|
|
75
|
+
"instructions": "Return cited Markdown. Separate verified facts, estimates, and evidence gaps.",
|
|
76
|
+
"depth": "deep",
|
|
77
|
+
"idempotency_key": "market-research:target-audience:INPUT_SHA256"
|
|
78
|
+
}'
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
- `query` contains the question and relevant product context.
|
|
82
|
+
- `instructions` contains stable scope, evidence, and output requirements.
|
|
83
|
+
- `depth` is `standard` or `deep`.
|
|
84
|
+
- `idempotency_key` identifies this exact logical attempt. Repeating it returns
|
|
85
|
+
the same job and does not spend another quota unit.
|
|
86
|
+
|
|
87
|
+
Persist `data.id` before doing other work. Through the Egbe connector without a
|
|
88
|
+
project folder, persist it, and later the result you rely on, in Egbe's artifact
|
|
89
|
+
store (for example `research/<id>/job.json`), as `egbe-os-quickstart` →
|
|
90
|
+
`references/artifact-sync.md` ("Through the Egbe connector") describes. A job ID
|
|
91
|
+
kept only in the conversation cannot be recovered after it.
|
|
92
|
+
|
|
93
|
+
## Poll
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/research/<job-id>" -s
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Statuses are `queued`, `running`, `completed`, and `failed`.
|
|
100
|
+
|
|
101
|
+
When completed, read `data.result.markdown`. Do not fetch a public report URL as
|
|
102
|
+
an agent input. On failure, inspect `data.error.code` and
|
|
103
|
+
`data.error.retryable`; do not silently switch providers or write substitute
|
|
104
|
+
research.
|
|
105
|
+
|
|
106
|
+
## Recover after an interruption or failure
|
|
107
|
+
|
|
108
|
+
- If submission/polling is interrupted, reuse the same payload and key (or poll
|
|
109
|
+
the saved job ID). A lost POST response does not mean the job was not accepted.
|
|
110
|
+
- `failed` is terminal. Repeating its key returns that failure, not a requeue;
|
|
111
|
+
HTTP 202 alone does not mean the engine is running. Read `data.status`.
|
|
112
|
+
- For `retryable: true`, a transient failure permits one deliberate new attempt
|
|
113
|
+
after a short wait. Persist a new stable key, e.g. append `:retry-1`, and reuse
|
|
114
|
+
that key for all submission/polling recovery. Stop and report repeated failure.
|
|
115
|
+
- For `retryable: false`, report the error and job ID. Model-access or upstream
|
|
116
|
+
authentication errors require Egbe to repair the service configuration. Start
|
|
117
|
+
a new attempt/key only after the cause is addressed.
|
|
118
|
+
|
|
119
|
+
## Limits
|
|
120
|
+
|
|
121
|
+
Each newly accepted idempotent job consumes one of 20 monthly research jobs per
|
|
122
|
+
instance. Polls, result reads, and duplicate submissions with the same key do
|
|
123
|
+
not consume another unit.
|
|
124
|
+
Failed jobs receive a best-effort quota refund; a failed refund does not permit
|
|
125
|
+
bypassing the quota limit.
|
|
@@ -0,0 +1,188 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-saas-unit-economics
|
|
3
|
+
description: Calculate subscription customer value, acquisition costs and funnel requirements from grounded inputs.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Offer when pricing or acquisition decisions need a viability check."
|
|
6
|
+
version: "1.4.0"
|
|
7
|
+
egbe-visible: "true"
|
|
8
|
+
egbe-title: "SaaS unit economics"
|
|
9
|
+
egbe-description: "Check subscription economics with measured data, explicit scenarios and traceable calculations."
|
|
10
|
+
egbe-category: "Business operations"
|
|
11
|
+
openclaw:
|
|
12
|
+
requires:
|
|
13
|
+
env: ["OS_API_KEY", "OS_URL"]
|
|
14
|
+
bins: ["curl", "jq"]
|
|
15
|
+
primaryEnv: "OS_API_KEY"
|
|
16
|
+
emoji: "💰"
|
|
17
|
+
os: ["linux", "darwin"]
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
21
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
22
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
23
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
24
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
25
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
26
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
27
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
28
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
29
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
30
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
31
|
+
`path` and `business`, and that `continuation`.
|
|
32
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
33
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
34
|
+
|
|
35
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
36
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
37
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
38
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
39
|
+
set-up project workspace. In a persistent
|
|
40
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
41
|
+
project setup describes.
|
|
42
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
43
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
44
|
+
|
|
45
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
46
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
47
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
48
|
+
saying Egbe is unavailable.
|
|
49
|
+
|
|
50
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
51
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
52
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
53
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
54
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
55
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
56
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
57
|
+
with an agent on their own computer. Code can also be published without the
|
|
58
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
59
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
60
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
61
|
+
deployment.
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
# Subscription unit economics
|
|
65
|
+
|
|
66
|
+
Calculate the economics needed for the current question using product evidence,
|
|
67
|
+
applicable benchmarks and explicit assumptions. Take the question and acceptable
|
|
68
|
+
risk from the caller's concrete task or plan. This skill supplies
|
|
69
|
+
calculations and validity checks, not a standing target for LTV/CAC, channel mix,
|
|
70
|
+
spend or conversion.
|
|
71
|
+
|
|
72
|
+
Reuse the product's existing `egbe-docs/product/economics.md` or linked test
|
|
73
|
+
calculation. Preserve measured values, sources and relevant prior assumptions;
|
|
74
|
+
do not overwrite them with a fresh benchmark forecast. Save only the calculations
|
|
75
|
+
needed for the task, not a compulsory full metric table or new master report.
|
|
76
|
+
|
|
77
|
+
## Establish the applicable inputs
|
|
78
|
+
|
|
79
|
+
Read the supplied brief, file, pricing page and existing records. Confirm which
|
|
80
|
+
product is meant only if ambiguous. Use an available browser when prices are
|
|
81
|
+
client-rendered; if unavailable, request the consequential missing price or leave
|
|
82
|
+
that scenario conditional. Do not infer current prices from search snippets.
|
|
83
|
+
|
|
84
|
+
These formulas apply to recurring monthly/annual subscription revenue. Identify
|
|
85
|
+
the actual billing, customer and cost units. A newsletter subscription and a
|
|
86
|
+
workflow SaaS can both recur but need different retention and cost evidence.
|
|
87
|
+
One-time purchases, transaction take-rates, ad revenue, and pure usage billing
|
|
88
|
+
need another model: explain the mismatch and do not force them into perpetual
|
|
89
|
+
monthly ARPU/churn. In a hybrid business, isolate the supported subscription
|
|
90
|
+
component and state what the calculation excludes.
|
|
91
|
+
|
|
92
|
+
Reuse observed cohort data when definitions, maturity and periods fit. Distinguish
|
|
93
|
+
observed values, externally observed benchmarks, product estimates and chosen
|
|
94
|
+
scenario assumptions. Do not invent a tier mix, churn adjustment, geography
|
|
95
|
+
discount, target ratio or conversion split to fill a table. Ask only for missing
|
|
96
|
+
inputs that would change the current decision; otherwise show a range, conditional
|
|
97
|
+
calculation or unavailable metric and explain what remains useful.
|
|
98
|
+
|
|
99
|
+
## Ground research and costs
|
|
100
|
+
|
|
101
|
+
Research only decision-relevant gaps. Before using Egbe search, read the live
|
|
102
|
+
`GET /search/skill`; the configured `OS_URL` and project `OS_API_KEY` need `tools`
|
|
103
|
+
scope. Credentials stay out of artifacts. This is an example query, not a
|
|
104
|
+
mandatory research stage or claim about the category:
|
|
105
|
+
|
|
106
|
+
```bash
|
|
107
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/web/brave" -fsS \
|
|
108
|
+
-H "Content-Type: application/json" \
|
|
109
|
+
-d '{"query":"monthly customer churn <relevant subscription category> cohort benchmark <current-year>","count":5}' \
|
|
110
|
+
| jq '.data.results[] | {title, url, snippet}'
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
Results use `data.results` and `snippet`; OS does not expose Brave's raw
|
|
114
|
+
`freshness` option. Verify publication dates and definitions on original pages.
|
|
115
|
+
An unavailable search source is a coverage gap, not permission to invent figures
|
|
116
|
+
or discard valid product data already available.
|
|
117
|
+
|
|
118
|
+
Compare category, buyer, product maturity, billing interval, acquisition channel,
|
|
119
|
+
geography, date, and measurement definition before applying a benchmark. Keep
|
|
120
|
+
reported ranges and sample limitations. A best-in-class statistic is not typical;
|
|
121
|
+
neither the low end nor midpoint of a published range is automatically a product
|
|
122
|
+
estimate. Triangulate consequential uncertain inputs where useful, without a
|
|
123
|
+
fixed source quota or averaging incompatible channels/cohorts. Explain any chosen
|
|
124
|
+
summary and adjustment. No automatic geographic or maturity multipliers apply.
|
|
125
|
+
|
|
126
|
+
Build product-specific COGS from applicable costs: hosting, storage/database,
|
|
127
|
+
third-party/AI usage, payment fees, support, and recurring content production,
|
|
128
|
+
localization or licensing where relevant. Use actual contracts/usage or labeled
|
|
129
|
+
estimates at a stated scale. Do not assume future volume discounts or optimized
|
|
130
|
+
support costs already exist. Separate fixed and variable costs and avoid counting
|
|
131
|
+
them twice; scenario comparisons can expose scale sensitivity. Include payment
|
|
132
|
+
fees at the actual billing frequency and applicable fee schedule, not a universal
|
|
133
|
+
processor percentage. Preserve links or other provenance for cost inputs.
|
|
134
|
+
|
|
135
|
+
## Calculations and validity
|
|
136
|
+
|
|
137
|
+
Use consistent currency, periods, population and gross/net revenue definitions.
|
|
138
|
+
Keep full precision internally and round for presentation. Rates below are
|
|
139
|
+
fractions, not percentage-point values.
|
|
140
|
+
|
|
141
|
+
| Quantity | Calculation | Conditions |
|
|
142
|
+
| --- | --- | --- |
|
|
143
|
+
| Monthly revenue per paying customer | recurring monthly revenue / paying customers | Same population and period; label a per-user denominator differently. Normalize annual revenue to monthly when comparing earned recurring revenue, not cash receipts. |
|
|
144
|
+
| Scenario ARPU from tiers | `sum(weight_i * monthly_price_i)` | Supported or explicitly proposed mix; nonnegative weights sum to one. Include discounts and billing mix where material. With no credible mix, show relevant tier/scenario values instead. |
|
|
145
|
+
| Gross margin | `(revenue - COGS) / revenue` | Positive revenue and compatible costs/periods. Negative margin is possible; do not clamp it or force a benchmark band. |
|
|
146
|
+
| Monthly customer churn | churned eligible customers / customers exposed to churn | Use a coherent cohort and exposure window; distinguish customer churn, revenue churn, refunds and net revenue retention. |
|
|
147
|
+
| Constant-hazard monthly equivalent | `1 - (1 - annual_customer_churn) ** (1/12)` | Only a conversion under constant monthly survival, not a measured monthly cohort rate or annual-contract cancellation cadence. |
|
|
148
|
+
| Approximate expected lifetime | `1 / monthly_customer_churn` months | Constant churn model with `0 < churn <= 1`; zero observed churn in a short/small cohort does not establish infinite lifetime. |
|
|
149
|
+
| Approximate gross-profit LTV | `ARPU * gross_margin / monthly_customer_churn` | Same steady-state model; excludes discounting, expansion and varying retention/cost. Label as a model, not guaranteed lifetime value. Use cohort/horizon contribution when this model does not fit. |
|
|
150
|
+
| Observed acquisition cost | attributable acquisition cost / acquired customers | State media-only vs fully loaded cost and comparable attribution/cohort window. No observed customers means undefined CAC, not zero or a fabricated finite number. |
|
|
151
|
+
| CPC | paid-media spend / measured ad clicks | Same source and window; zero clicks leaves CPC undefined. A click is not automatically a product visit. |
|
|
152
|
+
| Conditional required click-to-customer rate | `CPC / proposed_CAC` | Positive proposed CAC and consistent media-only cost basis. This is a requirement, not a forecast; greater than one is infeasible under the assumptions. |
|
|
153
|
+
| Conditional affordable CPC | `proposed_CAC * supported_click_to_customer_rate` | The conversion rate needs appropriate cohort evidence or an explicit scenario. It is not a provider bid recommendation. |
|
|
154
|
+
|
|
155
|
+
An affordable CAC is a plan decision, not LTV divided by a built-in constant.
|
|
156
|
+
If the plan chooses a positive LTV/CAC target `r`, its implied ceiling is `LTV/r`;
|
|
157
|
+
if it chooses a payback horizon, relate acquisition cost to contribution during
|
|
158
|
+
that horizon and state retention/cash-flow assumptions. Do not require either
|
|
159
|
+
target when the question can be answered without it. LTV-based sustainability
|
|
160
|
+
and a limited learning budget are different quantities.
|
|
161
|
+
|
|
162
|
+
Funnel stage probabilities can be multiplied only for linked conditional stages
|
|
163
|
+
of the same cohort: `P(signup | click) * P(paid | signup)` yields click-to-paid
|
|
164
|
+
when those stages cover the relevant path. Add arrival loss if starting at clicks
|
|
165
|
+
and the measured funnel starts at visits. Separate cohorts and unrelated period
|
|
166
|
+
totals do not establish these rates. A total conversion rate alone cannot identify
|
|
167
|
+
the stage split; leave it unidentified unless evidence or a labeled scenario
|
|
168
|
+
supplies an independent stage rate. There is no fixed signup/payment ratio.
|
|
169
|
+
|
|
170
|
+
Check finite values, positive denominators, rate bounds, weight sums and units.
|
|
171
|
+
An impossible required rate, nonpositive contribution or incompatible model is
|
|
172
|
+
an informative limitation, not a reason to hide the result or declare the whole
|
|
173
|
+
product unviable. Distinguish a mathematical error from an unsupported assumption.
|
|
174
|
+
Sensitivity cases should vary consequential assumptions coherently, not combine
|
|
175
|
+
every favorable cost with every unfavorable market statistic by rule.
|
|
176
|
+
|
|
177
|
+
## Return a traceable answer
|
|
178
|
+
|
|
179
|
+
Show the relevant observed/scenario metrics with units, scope and calculation
|
|
180
|
+
inputs. Record source URLs or file references, collection dates, original ranges,
|
|
181
|
+
definitions, chosen assumptions and material exclusions beside the calculation
|
|
182
|
+
or in a short source log. Do not label modeled LTV a proven minimum, a required
|
|
183
|
+
conversion rate an expected result, or provider CPC a guaranteed future cost.
|
|
184
|
+
|
|
185
|
+
Explain which assumption changes the answer and which evidence would improve it.
|
|
186
|
+
Return the supported calculation and implications to the caller; do not
|
|
187
|
+
change prices, budgets or campaigns as part of this calculation. Match the
|
|
188
|
+
founder's language and preserve unknowns instead of requiring every metric.
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-scrape
|
|
3
|
+
description: Extract structured data from websites and supported platforms.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when research needs collected web data rather than search results."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Web data extraction"
|
|
8
|
+
egbe-description: "Collect structured information from websites for research or data-powered product features."
|
|
9
|
+
egbe-category: "AI & data"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
13
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
14
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
15
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
16
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
17
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
18
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
19
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
20
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
21
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
22
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
23
|
+
`path` and `business`, and that `continuation`.
|
|
24
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
25
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
26
|
+
|
|
27
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
28
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
29
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
30
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
31
|
+
set-up project workspace. In a persistent
|
|
32
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
33
|
+
project setup describes.
|
|
34
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
35
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
36
|
+
|
|
37
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
38
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
39
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
40
|
+
saying Egbe is unavailable.
|
|
41
|
+
|
|
42
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
43
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
44
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
45
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
46
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
47
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
48
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
49
|
+
with an agent on their own computer. Code can also be published without the
|
|
50
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
51
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
52
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
53
|
+
deployment.
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
# Scrape (Apify)
|
|
57
|
+
|
|
58
|
+
Structured web scraping behind one shape. Address everything as
|
|
59
|
+
`/scrape/{source}/...` where `source` is `apify` (the only source today; more drop
|
|
60
|
+
in later). Authenticate with `Authorization: Bearer $OS_API_KEY`.
|
|
61
|
+
Base URL: `https://os.hz.egbe.dev`.
|
|
62
|
+
|
|
63
|
+
Use only the `OS_URL` and `OS_API_KEY` supplied to the current workload. Product
|
|
64
|
+
server code reads those same names; the Site Gateway injects a separate product
|
|
65
|
+
identity automatically. Never mint or deploy an Apify-specific key, and never
|
|
66
|
+
introduce `APIFY_API_KEY` or a direct provider token for this OS capability.
|
|
67
|
+
|
|
68
|
+
The lifecycle is the same regardless of source:
|
|
69
|
+
**account → discover an actor → run it → read the rows.**
|
|
70
|
+
|
|
71
|
+
## Account
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/account" -s
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Returns the provider account (plan, usage, remaining credit) under `data.raw`.
|
|
78
|
+
|
|
79
|
+
## Discover an actor
|
|
80
|
+
|
|
81
|
+
An "actor" is a ready-made scraper. Search the store, or skip straight to a known
|
|
82
|
+
actor id if you already know one (e.g. `apify/google-search-scraper`,
|
|
83
|
+
`compass/crawler-google-places`, `vdrmota/contact-info-scraper`).
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/actors?query=google%20maps%20reviews&limit=5" -s
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
`data.actors` is a compact `[{id, name, title, description}]` list. For the full
|
|
90
|
+
input schema of one actor:
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/actors/apify/google-search-scraper" -s
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## Run — synchronous (default)
|
|
97
|
+
|
|
98
|
+
The simplest path: `sync` is true by default, so the call blocks and returns the
|
|
99
|
+
scraped rows directly. Keep `limit` small to save credits, and always set the
|
|
100
|
+
actor's own cap field (`maxResults`, `maxPagesPerQuery`, …) inside `input`.
|
|
101
|
+
A synchronous run can wait up to about 5 minutes. Through the Egbe MCP
|
|
102
|
+
connection, start any run that may take over a minute asynchronously (below),
|
|
103
|
+
because the connector's client can stop waiting before a synchronous run returns.
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/run" -s -X POST \
|
|
107
|
+
-H 'Content-Type: application/json' \
|
|
108
|
+
-d '{
|
|
109
|
+
"actor": "apify/google-search-scraper",
|
|
110
|
+
"input": {"queries": "best AI tools 2026", "maxPagesPerQuery": 1, "countryCode": "us"},
|
|
111
|
+
"limit": 20
|
|
112
|
+
}'
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
`data` carries `rows` (the scraped records), `count`, and `raw`.
|
|
116
|
+
|
|
117
|
+
## Run — asynchronous (long jobs)
|
|
118
|
+
|
|
119
|
+
For big crawls pass `"sync": false`. You get a run handle back instead of rows;
|
|
120
|
+
poll the run, then read its dataset when it's `SUCCEEDED`.
|
|
121
|
+
|
|
122
|
+
Send a stable `Idempotency-Key` for every logical actor run. Persist the returned
|
|
123
|
+
`run_id` and `dataset_id`, then reuse or poll them after a retry instead of
|
|
124
|
+
starting another paid run. The header is a best-effort retry identity, not a
|
|
125
|
+
durable exactly-once guarantee if the start response is lost before the handle
|
|
126
|
+
is persisted.
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
# 1. start
|
|
130
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/run" -s -X POST \
|
|
131
|
+
-H 'Idempotency-Key: places-ramen-tokyo-v1' \
|
|
132
|
+
-H 'Content-Type: application/json' \
|
|
133
|
+
-d '{"actor":"compass/crawler-google-places","input":{"searchStringsArray":["ramen Tokyo"],"maxCrawledPlacesPerSearch":50},"sync":false}'
|
|
134
|
+
# -> data: {run_id, status, dataset_id}
|
|
135
|
+
|
|
136
|
+
# 2. poll
|
|
137
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/runs/<run_id>" -s
|
|
138
|
+
|
|
139
|
+
# 3. read rows once SUCCEEDED
|
|
140
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/datasets/<dataset_id>?limit=50" -s
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
## Passthrough — the native API
|
|
144
|
+
|
|
145
|
+
Anything the normalized verbs don't cover reaches the provider's own API:
|
|
146
|
+
|
|
147
|
+
```bash
|
|
148
|
+
# GET /scrape/apify/raw/store?search=tiktok -> tools-gateway /v1/apify/store?search=tiktok
|
|
149
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/raw/store?search=tiktok&limit=3" -s
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
Body and query string are forwarded as-is.
|
|
153
|
+
|
|
154
|
+
## Notes
|
|
155
|
+
|
|
156
|
+
- Set `$OS_URL` to `https://os.hz.egbe.dev` (or your local gateway).
|
|
157
|
+
- Always cap results: a `limit` on the call **and** the actor's own cap field in `input`.
|
|
158
|
+
- A non-empty result isn't proof of relevance — check the rows actually match the
|
|
159
|
+
requested place/topic/geography before trusting them.
|
|
160
|
+
- Actor ids accept both `user/actor` and `user~actor` forms.
|
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-search
|
|
3
|
+
description: Search the web and local businesses; retrieve place details and Google reviews.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when decisions need current sources or local-business discovery."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Web & places search"
|
|
8
|
+
egbe-description: "Find web pages, local businesses, and available Google reviews for research and product features."
|
|
9
|
+
egbe-category: "AI & data"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
13
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
14
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
15
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
16
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
17
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
18
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
19
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
20
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
21
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
22
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
23
|
+
`path` and `business`, and that `continuation`.
|
|
24
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
25
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
26
|
+
|
|
27
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
28
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
29
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
30
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
31
|
+
set-up project workspace. In a persistent
|
|
32
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
33
|
+
project setup describes.
|
|
34
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
35
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
36
|
+
|
|
37
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
38
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
39
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
40
|
+
saying Egbe is unavailable.
|
|
41
|
+
|
|
42
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
43
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
44
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
45
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
46
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
47
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
48
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
49
|
+
with an agent on their own computer. Code can also be published without the
|
|
50
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
51
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
52
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
53
|
+
deployment.
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
# Search
|
|
57
|
+
|
|
58
|
+
Web and places search behind concrete routes. Every provider returns the **same**
|
|
59
|
+
`SearchResponse` shape, so you parse the answer the same way no matter which one
|
|
60
|
+
you call. Authenticate with `Authorization: Bearer $OS_API_KEY`. A scoped key
|
|
61
|
+
needs the `tools` scope: without it every search route answers 403.
|
|
62
|
+
|
|
63
|
+
Base URL: `https://os.hz.egbe.dev`.
|
|
64
|
+
|
|
65
|
+
## Unified shape
|
|
66
|
+
|
|
67
|
+
```json
|
|
68
|
+
{
|
|
69
|
+
"provider": "brave",
|
|
70
|
+
"query": "best ramen in Tokyo",
|
|
71
|
+
"answer": null,
|
|
72
|
+
"results": [
|
|
73
|
+
{"title": "...", "url": "https://...", "snippet": "...", "score": null, "source": "brave", "metadata": {}}
|
|
74
|
+
],
|
|
75
|
+
"citations": [],
|
|
76
|
+
"count": 1
|
|
77
|
+
}
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
- `answer` — a synthesized text answer (only Perplexity fills this; `null` otherwise).
|
|
81
|
+
- `score` — a rating when the provider has one (Places stars); `null` otherwise.
|
|
82
|
+
- `metadata` — provider-specific extras (place_id, result age, etc.).
|
|
83
|
+
|
|
84
|
+
## Web search (Brave) — 250/day
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/web/brave" -s -X POST \
|
|
88
|
+
-H 'Content-Type: application/json' \
|
|
89
|
+
-d '{"query":"best ramen in Tokyo","count":5,"country":"jp","lang":"en"}'
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
`country` selects a Brave search region, not the product's target market. The
|
|
93
|
+
supported values (checked 2026-09-24 against the
|
|
94
|
+
[official API reference](https://api-dashboard.search.brave.com/api-reference/web/search/get)) are:
|
|
95
|
+
|
|
96
|
+
```text
|
|
97
|
+
AR AU AT BE BR CA CL DK FI FR DE GR HK IN ID IT JP KR MY MX NL NZ NO CN
|
|
98
|
+
PL PT PH RU SA ZA ES SE CH TW TR GB US ALL
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
OS normalizes case. ISO codes outside this list, including `AE` and `OM`, are
|
|
102
|
+
not supported search regions. Use `country: "ALL"` with the target country,
|
|
103
|
+
relevant official domains (`site:`) and language in the query; `lang` sets the
|
|
104
|
+
search language. Record that this is all-regions search, not local market data.
|
|
105
|
+
Omitting `country` uses the provider's US default, not an unbiased global search.
|
|
106
|
+
A 422 region error is not evidence of missing demand; correct the region once
|
|
107
|
+
and keep the intended market unchanged. Read original pages before treating
|
|
108
|
+
snippets as evidence; country search results are not a company census.
|
|
109
|
+
|
|
110
|
+
## AI research (Perplexity) — 20 successful submissions/claw/day, slow
|
|
111
|
+
|
|
112
|
+
Returns a synthesized `answer` plus `citations`. Heavily rate-limited (20 per
|
|
113
|
+
day per claw). This OS allowance is separate from the shared Perplexity API
|
|
114
|
+
credit balance. An upstream `insufficient_quota` error is a billing/credit
|
|
115
|
+
failure, not exhaustion of this daily allowance; stop and surface the error
|
|
116
|
+
instead of retrying or switching research providers.
|
|
117
|
+
|
|
118
|
+
**Deep research takes minutes — do NOT call it synchronously.** A blocking call
|
|
119
|
+
outlives your HTTP client timeout and you get a dropped connection (HTTP 000)
|
|
120
|
+
with no response body. Use the async submit/poll pair instead:
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
# 1. submit — returns immediately with a request_id
|
|
124
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/web/perplexity/async" -s -X POST \
|
|
125
|
+
-H 'Content-Type: application/json' \
|
|
126
|
+
-d '{"query":"What changed in EU AI Act enforcement in 2026?"}'
|
|
127
|
+
# -> {"request_id":"<id>","status":"PENDING","poll":"GET /search/web/perplexity/async/<id>"}
|
|
128
|
+
|
|
129
|
+
# 2. poll until status is COMPLETED, FAILED, CANCELLED or INCOMPLETE
|
|
130
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/web/perplexity/async/<id>" -s
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
Stop polling on any terminal status. `INCOMPLETE` means the provider stopped
|
|
134
|
+
before finishing (for example, output truncation); partial `answer` and `results`
|
|
135
|
+
may still be present. Inspect `error_message` for unsuccessful runs and preserve
|
|
136
|
+
the request ID rather than resubmitting automatically.
|
|
137
|
+
|
|
138
|
+
Async research uses Perplexity Agent background runs. Legacy Sonar model names
|
|
139
|
+
map to the provider's recommended presets (`sonar-deep-research` → `high`).
|
|
140
|
+
Async options: `model` (default `sonar-deep-research`), `reasoning_effort`
|
|
141
|
+
(`low|medium|high`), `system_prompt`.
|
|
142
|
+
|
|
143
|
+
The synchronous route still exists for quick calls, but it is bounded by a short
|
|
144
|
+
timeout: if it can't finish in time it returns a `504` envelope pointing you at
|
|
145
|
+
the async route rather than hanging.
|
|
146
|
+
|
|
147
|
+
```bash
|
|
148
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/web/perplexity" -s -X POST \
|
|
149
|
+
-H 'Content-Type: application/json' \
|
|
150
|
+
-d '{"query":"quick fact-check","preset":"deep-research"}'
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
Optional (sync): `preset` (research depth, default `"deep-research"`) and
|
|
154
|
+
`system_prompt`.
|
|
155
|
+
|
|
156
|
+
## Places (Google) — 200/day
|
|
157
|
+
|
|
158
|
+
Local businesses. `score` is the star rating; `url` links to Google Maps.
|
|
159
|
+
|
|
160
|
+
```bash
|
|
161
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/places" -s -X POST \
|
|
162
|
+
-H 'Content-Type: application/json' \
|
|
163
|
+
-d '{"query":"ramen in Shibuya","max_results":5,"region_code":"jp"}'
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
Optional: `language_code` (e.g. `"ja"`) for localized results.
|
|
167
|
+
|
|
168
|
+
### Place details and reviews
|
|
169
|
+
|
|
170
|
+
For business research or reputation monitoring, follow
|
|
171
|
+
[the Google Places workflow](references/google-places.md). It covers project
|
|
172
|
+
quotas, selecting `data.results[].metadata.place_id` from search, and fetching
|
|
173
|
+
details and available reviews through the existing OS `/tools/places/*` routes.
|
|
174
|
+
These operations return provider data inside the OS envelope; their shapes
|
|
175
|
+
are described in the workflow. Google returns at most five reviews per place,
|
|
176
|
+
not a complete review history.
|
|
177
|
+
|
|
178
|
+
If this skill was read inline from `/search/skill`, the supporting workflow is
|
|
179
|
+
available at `GET /skills/search/resources/references/google-places.md` or in
|
|
180
|
+
the complete `/skills/search` bundle.
|
|
181
|
+
|
|
182
|
+
List providers and the shape any time with `GET /search`.
|