@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,135 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-apollo-lead-finder
|
|
3
|
+
description: Search and enrich Apollo contacts or extract contact candidates from Places business websites through Egbe OS.
|
|
4
|
+
version: 1.1.2
|
|
5
|
+
user-invocable: true
|
|
6
|
+
argument-hint: "[find-leads --config <file> | search --titles <t> | enrich --input <file> | places-leads --queries <q;q>] --output <leads.json>"
|
|
7
|
+
metadata:
|
|
8
|
+
egbe-when: "Use for contact discovery, Apollo enrichment, or Places website sourcing."
|
|
9
|
+
egbe-visible: "true"
|
|
10
|
+
egbe-title: "Lead discovery"
|
|
11
|
+
egbe-description: "Search business contacts and return source status, enrichment progress and contact candidates."
|
|
12
|
+
egbe-category: "Marketing & growth"
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
16
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
17
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
18
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
19
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
20
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
21
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
22
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
23
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
24
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
25
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
26
|
+
`path` and `business`, and that `continuation`.
|
|
27
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
28
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
29
|
+
|
|
30
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
31
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
32
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
33
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
34
|
+
set-up project workspace. In a persistent
|
|
35
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
36
|
+
project setup describes.
|
|
37
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
38
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
39
|
+
|
|
40
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
41
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
42
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
43
|
+
saying Egbe is unavailable.
|
|
44
|
+
|
|
45
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
46
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
47
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
48
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
49
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
50
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
51
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
52
|
+
with an agent on their own computer. Code can also be published without the
|
|
53
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
54
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
55
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
56
|
+
deployment.
|
|
57
|
+
|
|
58
|
+
Run a script bundled with this skill from the root of a project folder set up
|
|
59
|
+
for Egbe, with `OS_AGENT_NAME="<your agent name>"` set inline, such as `OpenCode`.
|
|
60
|
+
A script that calls Egbe reads `OS_URL`, `OS_API_KEY` and this agent's connection
|
|
61
|
+
ID from `.env.local` through Egbe's request helper, which comes with the plugin at
|
|
62
|
+
`../egbe-os-quickstart/scripts/egbe-curl.py` from this skill's folder. Where this
|
|
63
|
+
skill says a script needs `OS_URL` or `OS_API_KEY` in its environment, start it
|
|
64
|
+
through the helper, which loads `.env.local` without executing it:
|
|
65
|
+
`python3 <helper> --egbe-run <command>`, with the helper's absolute path. Where
|
|
66
|
+
this skill writes `<skills-directory>`, use the plugin's `skills` folder, which
|
|
67
|
+
holds this skill's folder.
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
# Apollo Lead Finder
|
|
71
|
+
|
|
72
|
+
Use this capability for a requested contact search or enrichment. It does not
|
|
73
|
+
choose the audience, grant permission to spend or contact people, or require an
|
|
74
|
+
Instantly campaign.
|
|
75
|
+
|
|
76
|
+
Read [operations](references/operations.md) for commands, input/output shapes,
|
|
77
|
+
limits and recovery. The four commands are:
|
|
78
|
+
|
|
79
|
+
- `search`: live Apollo preview without enrichment; consumes search quota.
|
|
80
|
+
- `find-leads`: search followed by enrichment.
|
|
81
|
+
- `enrich`: enrich a compatible people list, or resume unfinished enrichment
|
|
82
|
+
from a partial Apollo result while preserving its existing leads.
|
|
83
|
+
- `places-leads`: Places search/details followed by guarded public website reads.
|
|
84
|
+
|
|
85
|
+
Use Node and `OS_URL` / `OS_API_KEY` (or `--env-file`). Authenticated provider
|
|
86
|
+
operations go through Egbe OS with Bearer auth; do not request separate Apollo
|
|
87
|
+
keys or bypass the gateway. Public website reads by Places are unauthenticated.
|
|
88
|
+
|
|
89
|
+
Set `--output` to a durable location in the access-controlled project repository:
|
|
90
|
+
the owning campaign's `egbe-docs/marketing/campaigns/instantly/<run_key>/leads.json`,
|
|
91
|
+
or `egbe-docs/research/<id>/work/` before a campaign exists. Keep the result's
|
|
92
|
+
source and completeness metadata with the contacts. Files contain personal data.
|
|
93
|
+
|
|
94
|
+
Check `meta.complete`, `stop_reason` and the unfinished inputs, not just the
|
|
95
|
+
number of emails. A completed zero-result search differs from an outage or quota
|
|
96
|
+
stop. Partial results remain usable evidence, not a claim that sourcing finished.
|
|
97
|
+
A provider status such as `verified` or `likely`, or a scraped `unverified`
|
|
98
|
+
address, does not establish current deliverability, relevance, consent or
|
|
99
|
+
authorization to send. These commands neither launch campaigns nor replace
|
|
100
|
+
downstream import verification.
|
|
101
|
+
|
|
102
|
+
## Through the Egbe connector
|
|
103
|
+
|
|
104
|
+
Without Node, make the scripts' requests with `egbe_write` and keep their
|
|
105
|
+
bounds. Each result's `data` is the provider body.
|
|
106
|
+
|
|
107
|
+
- **Search** (`POST /outreach/apollo/people/search`, consumes search quota): the
|
|
108
|
+
Apollo fields from [search inputs](references/operations.md#search-inputs),
|
|
109
|
+
plus `page` (from 1) and `per_page` (at most 100). Read `data.people`. Request
|
|
110
|
+
the next page until a page is empty or shorter than `per_page`, the page
|
|
111
|
+
reaches `data.pagination.total_pages` (missing pagination does not mean one
|
|
112
|
+
page) or you have the requested number. Deduplicate by person `id` across
|
|
113
|
+
pages; a page that adds no new `id` is a repeated page, an incomplete result
|
|
114
|
+
rather than the end.
|
|
115
|
+
- **Enrich** (`POST /outreach/apollo/people/bulk_match`, consumes enrichment
|
|
116
|
+
quota and can cost money): `{"details": [...]}` with at most 10 people, each
|
|
117
|
+
with `id`, or `linkedin_url`, or `first_name` and `last_name` with `domain` or
|
|
118
|
+
`organization_name`, and `"reveal_personal_emails": false`. Read
|
|
119
|
+
`data.matches`; a null entry is an unmatched person. `POST
|
|
120
|
+
/outreach/apollo/people/match` takes one such person.
|
|
121
|
+
- Keep a match as a lead only with an email, trimmed and lower-cased, once per
|
|
122
|
+
address; the scripts keep `email_status` `verified` and `likely` by default.
|
|
123
|
+
|
|
124
|
+
Save the result after every page or batch, before the next request, in the
|
|
125
|
+
`{leads, meta}` shape of
|
|
126
|
+
[operations](references/operations.md#enrichment-and-result-contract) with
|
|
127
|
+
`complete`, `stop_reason`, `processed_count` and the inputs not yet sent as
|
|
128
|
+
`not_enriched_people`. Keep it at its location above in Egbe's artifact store,
|
|
129
|
+
as `egbe-os-quickstart` → `references/artifact-sync.md` ("Through the Egbe
|
|
130
|
+
connector") describes; it holds personal data, so keep it nowhere else. A lost
|
|
131
|
+
response may already be charged: on resume send only the saved unsent inputs.
|
|
132
|
+
`places-leads` reads business websites with a guarded local client and needs a
|
|
133
|
+
set-up project workspace: in a persistent project workspace not set up yet, call
|
|
134
|
+
`egbe_local_setup`; otherwise tell the founder which step needs it. Through the
|
|
135
|
+
connector, use `egbe-os-search` for Places listings and details instead.
|
|
@@ -0,0 +1,240 @@
|
|
|
1
|
+
# Contact sourcing operations
|
|
2
|
+
|
|
3
|
+
## Connection and commands
|
|
4
|
+
|
|
5
|
+
Requires Node, `OS_URL` and `OS_API_KEY`. All commands accept
|
|
6
|
+
`--env-file <path>`; exported environment values take precedence. The shared
|
|
7
|
+
connection helper supplies agent identity headers when configured.
|
|
8
|
+
|
|
9
|
+
Authenticated routes:
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
POST $OS_URL/outreach/apollo/people/search
|
|
13
|
+
POST $OS_URL/outreach/apollo/people/match
|
|
14
|
+
POST $OS_URL/outreach/apollo/people/bulk_match
|
|
15
|
+
POST $OS_URL/search/places
|
|
16
|
+
POST $OS_URL/tools/places/details
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Use the installed skill directory for scripts and the project's durable output
|
|
20
|
+
directory for data. Shell wrappers with the same four names forward to Node.
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
node "$SKILL_DIR/scripts/search.js" --titles "VP Sales,Director of Sales" \
|
|
24
|
+
--employee-ranges "11,50;51,200" --max-results 20 --output "$WORK_DIR/preview.json"
|
|
25
|
+
node "$SKILL_DIR/scripts/enrich.js" --input "$WORK_DIR/preview.json" \
|
|
26
|
+
--output "$WORK_DIR/leads.json"
|
|
27
|
+
node "$SKILL_DIR/scripts/find-leads.js" --config "$WORK_DIR/search-config.json" \
|
|
28
|
+
--max-results 20 --time-budget-ms 90000 --output "$WORK_DIR/leads.json"
|
|
29
|
+
node "$SKILL_DIR/scripts/places-leads.js" --queries "accountants in Lisbon;accountants in Porto" \
|
|
30
|
+
--max-places 40 --email-preference generic --output "$WORK_DIR/places-leads.json"
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
These are live operations, not dry runs. No operation includes sending.
|
|
34
|
+
`--verbose` writes progress to stderr. Without `--output`, final JSON is stdout,
|
|
35
|
+
but there is no durable checkpoint if the process is killed.
|
|
36
|
+
|
|
37
|
+
## Search inputs
|
|
38
|
+
|
|
39
|
+
`search` and `find-leads` accept the same flags below. Lists are comma- or
|
|
40
|
+
semicolon-separated except employee ranges, which use semicolons between ranges.
|
|
41
|
+
Alternatively `--config` accepts a raw search object or `{"search": {...}}`;
|
|
42
|
+
config mode uses that object, not additional search-filter flags.
|
|
43
|
+
|
|
44
|
+
| Flag | Apollo field |
|
|
45
|
+
| --- | --- |
|
|
46
|
+
| `--titles`, `--not-titles` | `person_titles`, `person_not_titles` |
|
|
47
|
+
| `--seniorities` | `person_seniorities` |
|
|
48
|
+
| `--locations`, `--not-locations` | `person_locations`, `person_not_locations` |
|
|
49
|
+
| `--domains` | `q_organization_domains_list` |
|
|
50
|
+
| `--org-locations`, `--org-names` | `organization_locations`, `organization_names` |
|
|
51
|
+
| `--employee-ranges` | `organization_num_employees_ranges` (e.g. `["11,50","51,200"]`) |
|
|
52
|
+
| `--keywords`, `--industries` | `keywords`, `industry_tag_ids` |
|
|
53
|
+
| `--technologies` | `currently_using_any_of_technology_uids` |
|
|
54
|
+
| `--email-status` | `contact_email_status` (search filter) |
|
|
55
|
+
|
|
56
|
+
`--max-results` is a positive integer (default 50 for preview, 100 for combined
|
|
57
|
+
search/enrichment). The client requests pages of 100, caps pagination at 500 pages,
|
|
58
|
+
deduplicates IDs, honors supplied total pages and stops on short/empty pages.
|
|
59
|
+
Missing pagination does not mean there is only one page. A repeated page is an
|
|
60
|
+
incomplete result, not proof that the source is exhausted.
|
|
61
|
+
|
|
62
|
+
`search` outputs `{people: [...], meta: {...}}`, preserving provider records
|
|
63
|
+
including IDs and structured organization fields for enrichment. Display name
|
|
64
|
+
alone is not sufficient enrichment input.
|
|
65
|
+
|
|
66
|
+
## Enrichment and result contract
|
|
67
|
+
|
|
68
|
+
`enrich --input` accepts an array, `{people: [...]}`, compatible `{leads: [...]}`,
|
|
69
|
+
or the saved partial Apollo output. Each new input needs one of:
|
|
70
|
+
|
|
71
|
+
- `id` or `apollo_id`;
|
|
72
|
+
- `linkedin_url`;
|
|
73
|
+
- `first_name` and `last_name`, with a domain or company name.
|
|
74
|
+
|
|
75
|
+
Organization fields can be nested under `organization` or supplied as
|
|
76
|
+
`organization_name` / `company_name` / `company` and
|
|
77
|
+
`domain` / `company_domain` / `website`. Website URLs normalize to hostnames.
|
|
78
|
+
Unknown names are not fabricated from display names. The entire input is validated
|
|
79
|
+
before enrichment requests. An empty input is a valid completed empty operation.
|
|
80
|
+
|
|
81
|
+
The client batches at most ten people per call. `--email-status-filter` controls
|
|
82
|
+
retained enrichment results (default `verified,likely`; an empty string retains
|
|
83
|
+
all statuses). This is a selection setting, not a verification guarantee.
|
|
84
|
+
It is distinct from the search flag `--email-status`.
|
|
85
|
+
|
|
86
|
+
`find-leads` and `enrich` return:
|
|
87
|
+
|
|
88
|
+
```json
|
|
89
|
+
{
|
|
90
|
+
"leads": [],
|
|
91
|
+
"meta": {
|
|
92
|
+
"source": "apollo",
|
|
93
|
+
"complete": false,
|
|
94
|
+
"stop_reason": "daily_quota",
|
|
95
|
+
"enriched": 0,
|
|
96
|
+
"enriched_count": 0,
|
|
97
|
+
"processed_count": 0,
|
|
98
|
+
"leads_with_email": 0,
|
|
99
|
+
"email_status_filter": ["verified", "likely"],
|
|
100
|
+
"drops": {"no_email": 0, "email_status": 0, "duplicate_email": 0},
|
|
101
|
+
"not_enriched": 1,
|
|
102
|
+
"not_enriched_people": [{"id": "provider-person-id"}]
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
Leads have normalized `email`, available `first_name`, `last_name`,
|
|
108
|
+
`company_name`, `website`, `email_status`, `apollo_id`, and optional role,
|
|
109
|
+
location, company-size and LinkedIn fields. Empty fields stay empty. Addresses
|
|
110
|
+
are deduplicated, but a nonempty address is not a delivery check.
|
|
111
|
+
|
|
112
|
+
`processed_count` counts inputs in completed enrichment batches; `enriched`
|
|
113
|
+
and its `enriched_count` alias count non-null provider matches, before output
|
|
114
|
+
filtering. Null matches and matched people without emails are not queued for
|
|
115
|
+
automatic re-enrichment. `not_enriched` and `not_enriched_people` describe only
|
|
116
|
+
unprocessed inputs, not unmatched or status-filtered people. Zero results use
|
|
117
|
+
the same fields, rather than a special success shape.
|
|
118
|
+
|
|
119
|
+
For an HTTP failure during enrichment, SDK results include `error_status` and
|
|
120
|
+
`error`; CLI results and checkpoints keep these as `meta.error_status` and
|
|
121
|
+
`meta.error`, for example:
|
|
122
|
+
|
|
123
|
+
```json
|
|
124
|
+
{
|
|
125
|
+
"error_status": 422,
|
|
126
|
+
"error": {
|
|
127
|
+
"code": "insufficient_credits",
|
|
128
|
+
"message": "You have insufficient credits! Upgrade your plan to increase your number of lead credits."
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
The message is a safe diagnostic, not an instruction to upgrade or permission to
|
|
134
|
+
spend. Other codes include `validation_error`, `authorization`, `daily_quota`,
|
|
135
|
+
`rate_limited` and `provider_error`. Validation summaries contain at most ten
|
|
136
|
+
allowlisted `loc`/`type` entries with normalized messages; unknown path segments
|
|
137
|
+
are `[redacted]`. A `details` index is relative to the failed request's batch,
|
|
138
|
+
not the complete saved input list. Arbitrary provider text, input echoes, headers and credentials
|
|
139
|
+
are omitted. An unknown error explicitly says its details were omitted, rather
|
|
140
|
+
than claiming the original response was recovered. Search-only errors retain
|
|
141
|
+
their existing status/stop-reason contract.
|
|
142
|
+
|
|
143
|
+
`insufficient_credits` describes Apollo's shared-account capacity, independently
|
|
144
|
+
of remaining Egbe quota. Report it to Egbe support and preserve the checkpoint;
|
|
145
|
+
do not retry enrichment, purchase credits or request separate keys to diagnose
|
|
146
|
+
it. The existing project workflow must authorize any later continuation.
|
|
147
|
+
`processed_count: 0` and pending inputs are not proof that Apollo processed or
|
|
148
|
+
charged nothing. The diagnostic is not a billing receipt and cannot reconstruct
|
|
149
|
+
an error body discarded by an older SDK. Explicit `enrich --input <partial>`
|
|
150
|
+
continuation clears the prior enrichment error before its first checkpoint;
|
|
151
|
+
a new failure records its own diagnostic and a successful recovery leaves none.
|
|
152
|
+
|
|
153
|
+
Combined search includes `total_found`, `search_params`, `max_results`,
|
|
154
|
+
`search_complete`, `search_stop_reason`, `search_next_page` and `searched_at`.
|
|
155
|
+
Preview completion describes search only; its `not_enriched` is zero because no
|
|
156
|
+
enrichment was requested. `max_results` means the requested bound was met, not
|
|
157
|
+
that the entire audience was exhausted.
|
|
158
|
+
|
|
159
|
+
## Bounded execution and recovery
|
|
160
|
+
|
|
161
|
+
All commands accept a positive `--time-budget-ms` (default 90000). Apollo allows
|
|
162
|
+
at most four transport retries, honors Retry-After within that budget, and has no
|
|
163
|
+
second unbounded batch retry loop. Daily quota/configuration limits stop without
|
|
164
|
+
retrying. Transient HTTP failures may retry; transport/network uncertainty stops
|
|
165
|
+
the operation with pending inputs. A request may already have incurred cost when
|
|
166
|
+
its response is lost; recovery cannot promise exactly-once provider billing.
|
|
167
|
+
|
|
168
|
+
Exit codes:
|
|
169
|
+
|
|
170
|
+
- `0`: requested operation completed, including a genuine zero-result search.
|
|
171
|
+
- `2`: structured incomplete result; inspect the saved JSON even with no leads.
|
|
172
|
+
- `1`: invalid input/credentials or a local execution failure. Inspect an existing
|
|
173
|
+
checkpoint rather than assuming it contains nothing or blindly replacing it.
|
|
174
|
+
|
|
175
|
+
Reasons include `completed`, `search_exhausted`, `max_results`, `daily_quota`,
|
|
176
|
+
`rate_limited`, `time_budget`, `authorization`, `provider_error`,
|
|
177
|
+
`network_error`, `invalid_response`, `repeated_page`, and `max_pages`.
|
|
178
|
+
A checkpoint left with `in_progress` means the process did not finish; it is
|
|
179
|
+
never success. Missing OS credentials fail before requests. Check the OS key,
|
|
180
|
+
scope or upstream configuration for 401/403 or Apollo configuration failures.
|
|
181
|
+
Do not widen the audience or increase spending merely to turn an empty result
|
|
182
|
+
into a nonempty one.
|
|
183
|
+
|
|
184
|
+
With `--output`, writes replace JSON atomically before work and after every
|
|
185
|
+
completed page/batch. To continue already-found inputs:
|
|
186
|
+
|
|
187
|
+
```bash
|
|
188
|
+
node "$SKILL_DIR/scripts/enrich.js" --input "$WORK_DIR/leads.json" \
|
|
189
|
+
--output "$WORK_DIR/leads.json" --time-budget-ms 90000
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
This keeps existing leads and processes only `meta.not_enriched_people`; it
|
|
193
|
+
does not repeat search or successful batches. Preserve the existing email filter
|
|
194
|
+
when resuming: prior filtered provider matches are not stored for re-filtering.
|
|
195
|
+
If search itself was incomplete, enrichment does not claim the missing search
|
|
196
|
+
pages finished. `search_next_page` is diagnostic context, not an automatic
|
|
197
|
+
search-resume token.
|
|
198
|
+
|
|
199
|
+
Subprocess callers must give the client a smaller budget than their own timeout
|
|
200
|
+
(e.g. 90 seconds inside 120 seconds), read output on exit 2 and on interruption,
|
|
201
|
+
and preserve partial state before removing temporary directories. A hard kill
|
|
202
|
+
can leave the in-flight batch uncertain; completed checkpoints remain available.
|
|
203
|
+
|
|
204
|
+
## Places inputs, status and limits
|
|
205
|
+
|
|
206
|
+
`--queries` is a required semicolon-separated list; each search requests up to
|
|
207
|
+
20 results. `--exclude-categories` supplies optional name/type substring
|
|
208
|
+
exclusions. `--max-places` defaults to 60 and is clamped to a local cap of 200
|
|
209
|
+
unique places across the run. These are work bounds, not remaining provider quota.
|
|
210
|
+
|
|
211
|
+
Registry defaults are separate daily resources: Apollo searches 100 and
|
|
212
|
+
enrichments 200 people; Places searches, details and reviews each 200. Actual
|
|
213
|
+
project limits and operation charges may differ. One search and one details
|
|
214
|
+
request consume their respective resource, not a shared 200-request pool.
|
|
215
|
+
This script does not call reviews. A live preview and a Places sweep are not
|
|
216
|
+
free workarounds for quota or cost approval.
|
|
217
|
+
|
|
218
|
+
The pipeline gets listings, details and the website homepage, `/contact` and
|
|
219
|
+
`/about`. Each website/redirect is checked for public DNS/IPs and pinned to the
|
|
220
|
+
checked address; private, internal and credential-bearing URLs are refused.
|
|
221
|
+
Website requests carry no OS credentials. Trap-address and malformed-address
|
|
222
|
+
filters remain separate from optional ranking.
|
|
223
|
+
|
|
224
|
+
`--email-preference personal|generic|first` selects a ranking heuristic (default
|
|
225
|
+
`personal`). “Personal” only describes the local-part shape; it does not prove
|
|
226
|
+
ownership, recipient suitability or that a role mailbox is inferior. Name
|
|
227
|
+
extraction is an English-text heuristic: candidates are in `name_candidate` and
|
|
228
|
+
`name_candidate_source`, not silently filled into `first_name`. Address parsing
|
|
229
|
+
is also labeled heuristic. Check these candidates before using them in copy.
|
|
230
|
+
|
|
231
|
+
Places returns `leads/meta` with `source: "places"` and every email
|
|
232
|
+
`email_status: "unverified"`. It does not enrich Apollo people:
|
|
233
|
+
`enriched` and `not_enriched` are zero; `sites_scraped` is a separate counter.
|
|
234
|
+
`drops` separates details failures, unreadable websites, category exclusions,
|
|
235
|
+
missing websites/emails and duplicates. `pending_queries` and
|
|
236
|
+
`not_processed_places` retain unfinished work, with `complete: false` for
|
|
237
|
+
provider/website failures. Empty completed search, all failed searches and
|
|
238
|
+
filtered results are distinct. Places checkpoints are retained evidence;
|
|
239
|
+
`enrich` is not a Places recovery command. No automatic Places replay is
|
|
240
|
+
implemented; review the pending items before another paid sweep.
|