@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,653 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
"use strict";
|
|
3
|
+
const connectionHeaders = require('./lib/connection-identity');
|
|
4
|
+
const connectionIdentityByConfig = new WeakMap();
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* places-leads — Source business listings and public website contact candidates.
|
|
8
|
+
*
|
|
9
|
+
* 1. POST $OS_URL/search/places for each query (place names + place_ids)
|
|
10
|
+
* 2. POST $OS_URL/tools/places/details per place (websiteUri, types, phone)
|
|
11
|
+
* 3. Scrape each website (homepage + /contact + /about) for an email
|
|
12
|
+
* 4. Filter traps, prefer personal over generic addresses, emit the same
|
|
13
|
+
* output contract as find-leads.js with email_status "unverified"
|
|
14
|
+
*
|
|
15
|
+
* Search, details and reviews have separate project quotas and operation costs.
|
|
16
|
+
* The local processing cap is not a statement of available daily quota.
|
|
17
|
+
*
|
|
18
|
+
* Usage:
|
|
19
|
+
* node places-leads.js \
|
|
20
|
+
* --queries "real estate photographer austin;real estate photographer dallas" \
|
|
21
|
+
* --exclude-categories "headshot,wedding,portrait" \
|
|
22
|
+
* --max-places 60 --output leads.json [--env-file <path>] [--verbose]
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
const https = require("https");
|
|
26
|
+
const http = require("http");
|
|
27
|
+
const dns = require("dns");
|
|
28
|
+
const path = require("path");
|
|
29
|
+
const { URL } = require("url");
|
|
30
|
+
const { isDailyQuotaError, responseStopReason } = require("./lib/apollo-client");
|
|
31
|
+
const { positiveInteger } = require("./lib/sourcing");
|
|
32
|
+
const {
|
|
33
|
+
parseArgs,
|
|
34
|
+
writeJson,
|
|
35
|
+
isoNow,
|
|
36
|
+
normalizeEmail,
|
|
37
|
+
parseList,
|
|
38
|
+
parseSemicolonList,
|
|
39
|
+
readEnvFile,
|
|
40
|
+
getOsConfig,
|
|
41
|
+
} = require("./lib/helpers");
|
|
42
|
+
const {
|
|
43
|
+
GENERIC_LOCAL_PARTS,
|
|
44
|
+
FREEMAIL_DOMAINS,
|
|
45
|
+
classifyEmail,
|
|
46
|
+
extractOwnerFirstName,
|
|
47
|
+
} = require("./lib/places-filters");
|
|
48
|
+
|
|
49
|
+
const BROWSER_UA =
|
|
50
|
+
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 " +
|
|
51
|
+
"(KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36";
|
|
52
|
+
const FETCH_TIMEOUT_MS = 8000;
|
|
53
|
+
const MAX_REDIRECTS = 3;
|
|
54
|
+
const MAX_HTML_BYTES = 600_000;
|
|
55
|
+
// Places search returns at most 20 results per query (API page cap).
|
|
56
|
+
const SEARCH_PAGE_CAP = 20;
|
|
57
|
+
// The tools-gateway details default field mask has no primaryType/types, so
|
|
58
|
+
// request an explicit mask with everything the pipeline needs.
|
|
59
|
+
const DETAILS_FIELDS =
|
|
60
|
+
"id,displayName,formattedAddress,websiteUri,nationalPhoneNumber,primaryType,types";
|
|
61
|
+
// Conservative: bounded TLD ({2,24} covers long ICANN TLDs the target ICP
|
|
62
|
+
// actually uses — .photography, .construction), single-case TLD label so a
|
|
63
|
+
// mixed-case sentence glued after the address ("jane@janephoto.com.Call")
|
|
64
|
+
// cannot be matched as the TLD, and the match may not continue with a word
|
|
65
|
+
// char (avoids swallowing text concatenated after the address in minified
|
|
66
|
+
// HTML).
|
|
67
|
+
const EMAIL_RE =
|
|
68
|
+
/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.(?:[a-z]{2,24}|[A-Z]{2,24})(?![A-Za-z0-9-])/g;
|
|
69
|
+
|
|
70
|
+
function fail(msg) {
|
|
71
|
+
console.error(`FATAL: ${msg}`);
|
|
72
|
+
process.exit(1);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Authenticated OS request. Mirrors lib/apollo-client.js: retries transient
|
|
77
|
+
* statuses with backoff and unwraps the OS `{code, message, data}` envelope.
|
|
78
|
+
*/
|
|
79
|
+
async function osRequest(cfg, method, pathname, body = null, attempt = 0) {
|
|
80
|
+
if (Date.now() >= cfg.deadline) return { status: 0, stop_reason: "time_budget" };
|
|
81
|
+
if (!connectionIdentityByConfig.has(cfg)) connectionIdentityByConfig.set(cfg, connectionHeaders(cfg.osUrl, cfg.connectionEnvFile));
|
|
82
|
+
const url = new URL(cfg.osUrl.replace(/\/$/, "") + pathname);
|
|
83
|
+
const transport = url.protocol === "http:" ? http : https;
|
|
84
|
+
const payload = body == null ? null : JSON.stringify(body);
|
|
85
|
+
const options = {
|
|
86
|
+
method,
|
|
87
|
+
hostname: url.hostname,
|
|
88
|
+
port: url.port || (url.protocol === "http:" ? 80 : 443),
|
|
89
|
+
path: url.pathname + url.search,
|
|
90
|
+
headers: {
|
|
91
|
+
...connectionIdentityByConfig.get(cfg),
|
|
92
|
+
Authorization: `Bearer ${cfg.osApiKey}`,
|
|
93
|
+
"Content-Type": "application/json",
|
|
94
|
+
"Cache-Control": "no-cache",
|
|
95
|
+
},
|
|
96
|
+
timeout: Math.min(30000, cfg.deadline - Date.now()),
|
|
97
|
+
};
|
|
98
|
+
if (payload) options.headers["Content-Length"] = Buffer.byteLength(payload);
|
|
99
|
+
|
|
100
|
+
const response = await new Promise((resolve, reject) => {
|
|
101
|
+
const req = transport.request(options, (res) => {
|
|
102
|
+
let data = "";
|
|
103
|
+
res.on("data", (c) => (data += c));
|
|
104
|
+
res.on("end", () => {
|
|
105
|
+
clearTimeout(deadlineTimer);
|
|
106
|
+
let parsed = data;
|
|
107
|
+
try {
|
|
108
|
+
parsed = data ? JSON.parse(data) : null;
|
|
109
|
+
} catch {}
|
|
110
|
+
resolve({ status: res.statusCode, headers: res.headers, body: parsed });
|
|
111
|
+
});
|
|
112
|
+
res.on("error", (error) => { clearTimeout(deadlineTimer); reject(error); });
|
|
113
|
+
});
|
|
114
|
+
const deadlineTimer = setTimeout(() => req.destroy(new Error("Request time budget exceeded")), options.timeout);
|
|
115
|
+
req.on("error", (error) => { clearTimeout(deadlineTimer); reject(error); });
|
|
116
|
+
req.on("timeout", () => req.destroy(new Error("Request timeout")));
|
|
117
|
+
if (payload) req.write(payload);
|
|
118
|
+
req.end();
|
|
119
|
+
});
|
|
120
|
+
|
|
121
|
+
const retryable = [408, 429, 500, 502, 503, 504].includes(response.status);
|
|
122
|
+
if (retryable && attempt < 3 && !isDailyQuotaError(response)) {
|
|
123
|
+
const retryAfter = Number(response.headers["retry-after"] || 0);
|
|
124
|
+
const delayMs = retryAfter > 0 ? retryAfter * 1000 : 1000 * Math.pow(2, attempt);
|
|
125
|
+
if (delayMs >= cfg.deadline - Date.now()) return { ...response, stop_reason: "time_budget" };
|
|
126
|
+
if (cfg.verbose)
|
|
127
|
+
console.error(`Retry ${attempt + 1} after ${delayMs}ms (status ${response.status})`);
|
|
128
|
+
await new Promise((r) => setTimeout(r, delayMs));
|
|
129
|
+
return osRequest(cfg, method, pathname, body, attempt + 1);
|
|
130
|
+
}
|
|
131
|
+
if (cfg.verbose) console.error(`${method} ${url.pathname} -> ${response.status}`);
|
|
132
|
+
if (
|
|
133
|
+
response.status >= 200 &&
|
|
134
|
+
response.status < 300 &&
|
|
135
|
+
response.body &&
|
|
136
|
+
typeof response.body === "object" &&
|
|
137
|
+
Object.prototype.hasOwnProperty.call(response.body, "data")
|
|
138
|
+
) {
|
|
139
|
+
response.body = response.body.data;
|
|
140
|
+
}
|
|
141
|
+
return response;
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
// --- SSRF guard -------------------------------------------------------------
|
|
145
|
+
// websiteUri comes from a third-party Places listing, and a public site can
|
|
146
|
+
// 302 to loopback / RFC1918 / link-local (cloud metadata) addresses. Mirror
|
|
147
|
+
// tools-gateway/app/providers/destination_urls.py: reject internal hosts up
|
|
148
|
+
// front, resolve DNS once per hop, refuse any non-public answer, and pin the
|
|
149
|
+
// connection to the vetted address (Host header + SNI keep the logical
|
|
150
|
+
// hostname) so a rebinding second lookup cannot redirect the request.
|
|
151
|
+
|
|
152
|
+
const INTERNAL_HOST_SUFFIXES = [".gcp.egbe.dev", ".hz.egbe.dev"];
|
|
153
|
+
|
|
154
|
+
function isGlobalIpv4(ip) {
|
|
155
|
+
const octets = ip.split(".").map(Number);
|
|
156
|
+
if (octets.length !== 4 || octets.some((n) => !Number.isInteger(n) || n < 0 || n > 255)) {
|
|
157
|
+
return false;
|
|
158
|
+
}
|
|
159
|
+
const [a, b] = octets;
|
|
160
|
+
if (a === 0 || a === 10 || a === 127) return false;
|
|
161
|
+
if (a === 100 && b >= 64 && b <= 127) return false; // CGNAT 100.64/10
|
|
162
|
+
if (a === 169 && b === 254) return false; // link-local incl. metadata
|
|
163
|
+
if (a === 172 && b >= 16 && b <= 31) return false;
|
|
164
|
+
if (a === 192 && b === 168) return false;
|
|
165
|
+
if (a === 192 && b === 0) return false; // 192.0.0/24 + 192.0.2/24 doc
|
|
166
|
+
if (a === 198 && (b === 18 || b === 19)) return false; // benchmarking
|
|
167
|
+
if (a === 198 && b === 51) return false; // 198.51.100/24 doc
|
|
168
|
+
if (a === 203 && b === 0) return false; // 203.0.113/24 doc
|
|
169
|
+
if (a >= 224) return false; // multicast, reserved, broadcast
|
|
170
|
+
return true;
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
function isGlobalIp(ip) {
|
|
174
|
+
const value = String(ip || "").toLowerCase();
|
|
175
|
+
if (!value) return false;
|
|
176
|
+
if (value.includes(":")) {
|
|
177
|
+
const mapped = value.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/);
|
|
178
|
+
if (mapped) return isGlobalIpv4(mapped[1]);
|
|
179
|
+
if (value === "::" || value === "::1") return false;
|
|
180
|
+
if (/^f[cd]/.test(value)) return false; // fc00::/7 unique-local
|
|
181
|
+
if (/^fe[89ab]/.test(value)) return false; // fe80::/10 link-local
|
|
182
|
+
if (/^ff/.test(value)) return false; // multicast
|
|
183
|
+
if (value.startsWith("2001:db8")) return false; // documentation
|
|
184
|
+
return /^[23]/.test(value); // 2000::/3 global unicast
|
|
185
|
+
}
|
|
186
|
+
return isGlobalIpv4(value);
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* Resolve a hostname and return one vetted public address, or null when the
|
|
191
|
+
* host is internal, unresolvable, or ANY answer is a non-public address.
|
|
192
|
+
*/
|
|
193
|
+
async function resolvePublicAddress(hostname) {
|
|
194
|
+
const host = String(hostname || "")
|
|
195
|
+
.toLowerCase()
|
|
196
|
+
.replace(/\.$/, "");
|
|
197
|
+
if (!host || host === "localhost" || host.endsWith(".localhost")) return null;
|
|
198
|
+
if (
|
|
199
|
+
INTERNAL_HOST_SUFFIXES.some(
|
|
200
|
+
(suffix) => host === suffix.slice(1) || host.endsWith(suffix),
|
|
201
|
+
)
|
|
202
|
+
) {
|
|
203
|
+
return null;
|
|
204
|
+
}
|
|
205
|
+
if (/^[\d.]+$/.test(host) || host.includes(":")) {
|
|
206
|
+
const literal = host.replace(/^\[|\]$/g, "");
|
|
207
|
+
return isGlobalIp(literal) ? literal : null;
|
|
208
|
+
}
|
|
209
|
+
let answers;
|
|
210
|
+
try {
|
|
211
|
+
answers = await dns.promises.lookup(host, { all: true, verbatim: true });
|
|
212
|
+
} catch {
|
|
213
|
+
return null;
|
|
214
|
+
}
|
|
215
|
+
if (!answers.length || answers.some((entry) => !isGlobalIp(entry.address))) {
|
|
216
|
+
return null;
|
|
217
|
+
}
|
|
218
|
+
return answers[0].address;
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
/**
|
|
222
|
+
* Plain GET with a browser-ish User-Agent. Follows up to MAX_REDIRECTS with
|
|
223
|
+
* every hop re-validated and pinned to a vetted public address, skips
|
|
224
|
+
* non-HTML responses, truncates huge pages. Resolves to the HTML string or
|
|
225
|
+
* null — never rejects.
|
|
226
|
+
*/
|
|
227
|
+
async function fetchHtml(rawUrl, redirectsLeft = MAX_REDIRECTS, deadline = Infinity) {
|
|
228
|
+
if (Date.now() >= deadline) return null;
|
|
229
|
+
let url;
|
|
230
|
+
try {
|
|
231
|
+
url = new URL(rawUrl);
|
|
232
|
+
} catch {
|
|
233
|
+
return null;
|
|
234
|
+
}
|
|
235
|
+
if (url.protocol !== "http:" && url.protocol !== "https:") return null;
|
|
236
|
+
if (url.username || url.password) return null;
|
|
237
|
+
let dnsTimer;
|
|
238
|
+
const address = await Promise.race([
|
|
239
|
+
resolvePublicAddress(url.hostname),
|
|
240
|
+
new Promise((resolve) => { dnsTimer = setTimeout(() => resolve(null), Math.min(FETCH_TIMEOUT_MS, deadline - Date.now())); }),
|
|
241
|
+
]);
|
|
242
|
+
clearTimeout(dnsTimer);
|
|
243
|
+
if (!address) return null;
|
|
244
|
+
const transport = url.protocol === "http:" ? http : https;
|
|
245
|
+
|
|
246
|
+
const outcome = await new Promise((resolve) => {
|
|
247
|
+
let settled = false;
|
|
248
|
+
let deadlineTimer;
|
|
249
|
+
const settle = (value) => {
|
|
250
|
+
if (!settled) {
|
|
251
|
+
settled = true;
|
|
252
|
+
clearTimeout(deadlineTimer);
|
|
253
|
+
resolve(value);
|
|
254
|
+
}
|
|
255
|
+
};
|
|
256
|
+
const req = transport.get(
|
|
257
|
+
{
|
|
258
|
+
host: address,
|
|
259
|
+
port: url.port || (url.protocol === "http:" ? 80 : 443),
|
|
260
|
+
path: url.pathname + url.search,
|
|
261
|
+
headers: {
|
|
262
|
+
Host: url.host,
|
|
263
|
+
"User-Agent": BROWSER_UA,
|
|
264
|
+
Accept: "text/html,application/xhtml+xml;q=0.9,*/*;q=0.5",
|
|
265
|
+
},
|
|
266
|
+
...(url.protocol === "https:" ? { servername: url.hostname } : {}),
|
|
267
|
+
timeout: Math.min(FETCH_TIMEOUT_MS, Math.max(1, deadline - Date.now())),
|
|
268
|
+
},
|
|
269
|
+
(res) => {
|
|
270
|
+
const status = res.statusCode || 0;
|
|
271
|
+
const location = res.headers.location;
|
|
272
|
+
if (status >= 300 && status < 400 && location && redirectsLeft > 0) {
|
|
273
|
+
res.resume();
|
|
274
|
+
let next;
|
|
275
|
+
try {
|
|
276
|
+
next = new URL(location, url).toString();
|
|
277
|
+
} catch {
|
|
278
|
+
return settle({ html: null });
|
|
279
|
+
}
|
|
280
|
+
return settle({ redirect: next });
|
|
281
|
+
}
|
|
282
|
+
const contentType = String(res.headers["content-type"] || "");
|
|
283
|
+
if (status !== 200 || (contentType && !contentType.includes("text/html"))) {
|
|
284
|
+
res.resume();
|
|
285
|
+
return settle({ html: null });
|
|
286
|
+
}
|
|
287
|
+
let data = "";
|
|
288
|
+
res.setEncoding("utf8");
|
|
289
|
+
res.on("data", (chunk) => {
|
|
290
|
+
data += chunk;
|
|
291
|
+
if (data.length > MAX_HTML_BYTES) {
|
|
292
|
+
settle({ html: data });
|
|
293
|
+
req.destroy();
|
|
294
|
+
}
|
|
295
|
+
});
|
|
296
|
+
res.on("end", () => settle({ html: data }));
|
|
297
|
+
res.on("error", () => settle({ html: data || null }));
|
|
298
|
+
},
|
|
299
|
+
);
|
|
300
|
+
deadlineTimer = setTimeout(() => { settle({ html: null }); req.destroy(); }, Math.min(FETCH_TIMEOUT_MS, Math.max(1, deadline - Date.now())));
|
|
301
|
+
req.on("timeout", () => req.destroy());
|
|
302
|
+
req.on("error", () => settle({ html: null }));
|
|
303
|
+
});
|
|
304
|
+
|
|
305
|
+
if (outcome.redirect) {
|
|
306
|
+
// Recurse so the redirect target goes through the same host/DNS vetting
|
|
307
|
+
// and address pinning as the original URL.
|
|
308
|
+
return fetchHtml(outcome.redirect, redirectsLeft - 1, deadline);
|
|
309
|
+
}
|
|
310
|
+
return outcome.html;
|
|
311
|
+
}
|
|
312
|
+
|
|
313
|
+
/** Emails from mailto: links plus a conservative regex over the raw HTML. */
|
|
314
|
+
function extractEmails(html) {
|
|
315
|
+
const out = new Set();
|
|
316
|
+
const source = String(html || "");
|
|
317
|
+
const mailtoRe = /mailto:([^"'\s<>]+)/gi;
|
|
318
|
+
let m;
|
|
319
|
+
while ((m = mailtoRe.exec(source))) {
|
|
320
|
+
let candidate = m[1].split("?")[0];
|
|
321
|
+
try {
|
|
322
|
+
candidate = decodeURIComponent(candidate);
|
|
323
|
+
} catch {}
|
|
324
|
+
for (const hit of candidate.match(EMAIL_RE) || []) out.add(normalizeEmail(hit));
|
|
325
|
+
}
|
|
326
|
+
for (const hit of source.match(EMAIL_RE) || []) out.add(normalizeEmail(hit));
|
|
327
|
+
return [...out].filter(Boolean);
|
|
328
|
+
}
|
|
329
|
+
|
|
330
|
+
/** Crude but dependency-free HTML -> text for owner-name extraction. */
|
|
331
|
+
function htmlToText(html) {
|
|
332
|
+
return String(html || "")
|
|
333
|
+
.replace(/<script[\s\S]*?<\/script>/gi, " ")
|
|
334
|
+
.replace(/<style[\s\S]*?<\/style>/gi, " ")
|
|
335
|
+
.replace(/<[^>]+>/g, " ")
|
|
336
|
+
.replace(/&/g, "&")
|
|
337
|
+
.replace(/&(?:#39|#8217|apos|rsquo);/g, "'")
|
|
338
|
+
.replace(/"/g, '"')
|
|
339
|
+
.replace(/ /g, " ")
|
|
340
|
+
.replace(/\s+/g, " ")
|
|
341
|
+
.trim();
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
function pageTitle(html) {
|
|
345
|
+
const m = String(html || "").match(/<title[^>]*>([\s\S]*?)<\/title>/i);
|
|
346
|
+
return m ? htmlToText(m[1]) : "";
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
/** Best-effort {city, state, country} from a Places formattedAddress. */
|
|
350
|
+
function parseAddress(formatted) {
|
|
351
|
+
const parts = String(formatted || "")
|
|
352
|
+
.split(",")
|
|
353
|
+
.map((s) => s.trim())
|
|
354
|
+
.filter(Boolean);
|
|
355
|
+
if (parts.length < 3) return { city: "", state: "", country: "" };
|
|
356
|
+
return {
|
|
357
|
+
city: parts[parts.length - 3],
|
|
358
|
+
state: parts[parts.length - 2].replace(/[\d-]+/g, "").trim(),
|
|
359
|
+
country: parts[parts.length - 1],
|
|
360
|
+
};
|
|
361
|
+
}
|
|
362
|
+
|
|
363
|
+
function toDomain(websiteUri) {
|
|
364
|
+
try {
|
|
365
|
+
return new URL(websiteUri).hostname.replace(/^www\./, "");
|
|
366
|
+
} catch {
|
|
367
|
+
return String(websiteUri || "");
|
|
368
|
+
}
|
|
369
|
+
}
|
|
370
|
+
|
|
371
|
+
/**
|
|
372
|
+
* Heuristic ranking, not evidence of ownership or suitability:
|
|
373
|
+
* 0. personal local-part on the site's own domain
|
|
374
|
+
* 1. personal-looking on a freemail provider
|
|
375
|
+
* 2. generic on the site's own domain (GENERIC_LOCAL_PARTS order)
|
|
376
|
+
* 3. generic elsewhere
|
|
377
|
+
* 4. personal on an unrelated non-freemail domain — usually a third party
|
|
378
|
+
* embedded in the page (designer credit, partner studio), last resort
|
|
379
|
+
*/
|
|
380
|
+
function pickEmail(candidates, siteDomain, preference = "personal") {
|
|
381
|
+
const site = String(siteDomain || "").toLowerCase();
|
|
382
|
+
let best = null;
|
|
383
|
+
let bestScore = Infinity;
|
|
384
|
+
for (const email of candidates) {
|
|
385
|
+
const kind = classifyEmail(email);
|
|
386
|
+
if (kind === "trap") continue;
|
|
387
|
+
if (preference === "first") return { email, kind };
|
|
388
|
+
const domain = String(email).toLowerCase().split("@")[1] || "";
|
|
389
|
+
const onSite =
|
|
390
|
+
!!site && (domain === site || domain.endsWith(`.${site}`) || site.endsWith(`.${domain}`));
|
|
391
|
+
const genericRank = Math.max(
|
|
392
|
+
0,
|
|
393
|
+
GENERIC_LOCAL_PARTS.indexOf(String(email).toLowerCase().split("@")[0]),
|
|
394
|
+
);
|
|
395
|
+
let score;
|
|
396
|
+
if (kind === "personal" && onSite) score = 0;
|
|
397
|
+
else if (kind === "personal" && FREEMAIL_DOMAINS.has(domain)) score = 1;
|
|
398
|
+
else if (kind === "generic" && onSite) score = 2 + genericRank / 100;
|
|
399
|
+
else if (kind === "generic") score = 3 + genericRank / 100;
|
|
400
|
+
else score = 4;
|
|
401
|
+
if (preference === "generic" && kind === "generic") score -= 3;
|
|
402
|
+
if (score < bestScore) {
|
|
403
|
+
bestScore = score;
|
|
404
|
+
best = { email, kind };
|
|
405
|
+
}
|
|
406
|
+
}
|
|
407
|
+
return best;
|
|
408
|
+
}
|
|
409
|
+
|
|
410
|
+
async function main() {
|
|
411
|
+
const args = parseArgs(process.argv);
|
|
412
|
+
const verbose = !!args.verbose;
|
|
413
|
+
|
|
414
|
+
const env = args["env-file"] ? readEnvFile(path.resolve(args["env-file"])) : {};
|
|
415
|
+
const os = getOsConfig({ ...env, ...process.env });
|
|
416
|
+
if (os.missing.length)
|
|
417
|
+
fail(`${os.missing.join(" and ")} not set. Export them or pass --env-file.`);
|
|
418
|
+
const cfg = { osUrl: os.osUrl, osApiKey: os.osApiKey, verbose,
|
|
419
|
+
deadline: Date.now() + positiveInteger(args["time-budget-ms"], 90000, "--time-budget-ms"),
|
|
420
|
+
connectionEnvFile: args["env-file"] ? path.resolve(args["env-file"]) : null };
|
|
421
|
+
|
|
422
|
+
const queries = parseSemicolonList(args.queries);
|
|
423
|
+
if (!queries.length) fail('--queries is required (semicolon-separated, e.g. "a;b")');
|
|
424
|
+
const excludeCategories = parseList(args["exclude-categories"]).map((t) =>
|
|
425
|
+
t.toLowerCase(),
|
|
426
|
+
);
|
|
427
|
+
// A local bound on work, independent of current project provider quotas.
|
|
428
|
+
const MAX_PLACES_CAP = 200;
|
|
429
|
+
const maxPlacesRaw =
|
|
430
|
+
args["max-places"] == null ? 60 : Number(args["max-places"]);
|
|
431
|
+
if (!Number.isInteger(maxPlacesRaw) || maxPlacesRaw <= 0) {
|
|
432
|
+
fail(
|
|
433
|
+
`--max-places must be a positive integer, got "${args["max-places"]}"`,
|
|
434
|
+
);
|
|
435
|
+
}
|
|
436
|
+
const maxPlaces = Math.min(maxPlacesRaw, MAX_PLACES_CAP);
|
|
437
|
+
if (maxPlaces < maxPlacesRaw) {
|
|
438
|
+
console.error(
|
|
439
|
+
`--max-places clamped from ${maxPlacesRaw} to ${MAX_PLACES_CAP} (local script cap, not a provider quota)`,
|
|
440
|
+
);
|
|
441
|
+
}
|
|
442
|
+
const outputPath = args.output ? path.resolve(args.output) : null;
|
|
443
|
+
const emailPreference = args["email-preference"] || "personal";
|
|
444
|
+
if (!["personal", "generic", "first"].includes(emailPreference)) fail("--email-preference must be personal, generic or first");
|
|
445
|
+
const drops = { details_failed: 0, scrape_failed: 0, category: 0, no_website: 0, no_email: 0, duplicate_email: 0 };
|
|
446
|
+
let sitesScraped = 0;
|
|
447
|
+
let emailsFound = 0;
|
|
448
|
+
const seenEmails = new Set();
|
|
449
|
+
const leads = [];
|
|
450
|
+
const pendingPlaces = new Map();
|
|
451
|
+
const pendingQueries = new Set(queries);
|
|
452
|
+
let stopReason = null;
|
|
453
|
+
const result = { leads, meta: {
|
|
454
|
+
searched_at: isoNow(), search_params: { queries, exclude_categories: excludeCategories,
|
|
455
|
+
max_places: maxPlaces, email_preference: emailPreference }, source: "places",
|
|
456
|
+
complete: false, stop_reason: "in_progress", total_found: 0, enriched: 0,
|
|
457
|
+
not_enriched: 0, not_enriched_people: [], sites_scraped: 0, leads_with_email: 0,
|
|
458
|
+
email_status_filter: ["unverified"], search_failures: 0, drops,
|
|
459
|
+
pending_queries: queries.slice(), not_processed_places: [],
|
|
460
|
+
} };
|
|
461
|
+
const checkpoint = () => {
|
|
462
|
+
Object.assign(result.meta, { total_found: places.size, sites_scraped: sitesScraped,
|
|
463
|
+
leads_with_email: leads.length, search_failures: searchFailures,
|
|
464
|
+
pending_queries: [...pendingQueries], not_processed_places: [...pendingPlaces.values()] });
|
|
465
|
+
if (outputPath) writeJson(outputPath, result);
|
|
466
|
+
};
|
|
467
|
+
|
|
468
|
+
// --- Step 1: Places search (one quota unit per query) ---
|
|
469
|
+
const places = new Map(); // place_id -> {place_id, name, address}
|
|
470
|
+
let searchSuccesses = 0;
|
|
471
|
+
let searchFailures = 0;
|
|
472
|
+
let lastSearchFailure = null;
|
|
473
|
+
checkpoint();
|
|
474
|
+
for (const query of queries) {
|
|
475
|
+
if (places.size >= maxPlaces) {
|
|
476
|
+
console.error(`Skipping "${query}": --max-places ${maxPlaces} reached`);
|
|
477
|
+
pendingQueries.delete(query);
|
|
478
|
+
continue;
|
|
479
|
+
}
|
|
480
|
+
let res;
|
|
481
|
+
try { res = await osRequest(cfg, "POST", "/search/places", {
|
|
482
|
+
query,
|
|
483
|
+
max_results: Math.min(SEARCH_PAGE_CAP, maxPlaces - places.size),
|
|
484
|
+
}); } catch { res = { status: 0, stop_reason: Date.now() >= cfg.deadline ? "time_budget" : "network_error" }; }
|
|
485
|
+
if (res.status !== 200) {
|
|
486
|
+
// Auth/quota failure hits every remaining query identically — stop
|
|
487
|
+
// now instead of logging N times and writing a fake-empty result.
|
|
488
|
+
searchFailures += 1;
|
|
489
|
+
stopReason = responseStopReason(res);
|
|
490
|
+
lastSearchFailure = `${res.status} ${JSON.stringify(res.body)}`;
|
|
491
|
+
console.error(`Search failed for "${query}": ${lastSearchFailure}`);
|
|
492
|
+
checkpoint();
|
|
493
|
+
if ([401, 403, 429, 0].includes(res.status)) break;
|
|
494
|
+
continue;
|
|
495
|
+
}
|
|
496
|
+
if (!Array.isArray(res.body?.results)) { searchFailures++; stopReason = "invalid_response"; checkpoint(); continue; }
|
|
497
|
+
pendingQueries.delete(query);
|
|
498
|
+
searchSuccesses += 1;
|
|
499
|
+
const results = res.body?.results || [];
|
|
500
|
+
let added = 0;
|
|
501
|
+
for (const r of results) {
|
|
502
|
+
const placeId = r?.metadata?.place_id;
|
|
503
|
+
if (!placeId || places.has(placeId)) continue;
|
|
504
|
+
if (places.size >= maxPlaces) break;
|
|
505
|
+
const place = {
|
|
506
|
+
place_id: placeId,
|
|
507
|
+
name: r.title || "",
|
|
508
|
+
address: r.snippet || "",
|
|
509
|
+
};
|
|
510
|
+
places.set(placeId, place);
|
|
511
|
+
pendingPlaces.set(placeId, place);
|
|
512
|
+
added += 1;
|
|
513
|
+
}
|
|
514
|
+
console.error(`Query "${query}": ${results.length} places (${added} new)`);
|
|
515
|
+
checkpoint();
|
|
516
|
+
}
|
|
517
|
+
console.error(`${places.size} unique places found. Fetching details...`);
|
|
518
|
+
|
|
519
|
+
// --- Steps 2-5: details -> category filter -> scrape -> classify ---
|
|
520
|
+
for (const place of places.values()) {
|
|
521
|
+
try {
|
|
522
|
+
const res = await osRequest(cfg, "POST", "/tools/places/details", {
|
|
523
|
+
place_id: place.place_id,
|
|
524
|
+
fields: DETAILS_FIELDS,
|
|
525
|
+
});
|
|
526
|
+
if (res.status !== 200) {
|
|
527
|
+
drops.details_failed += 1;
|
|
528
|
+
stopReason = responseStopReason(res);
|
|
529
|
+
if (verbose)
|
|
530
|
+
console.error(`Details failed for ${place.place_id}: ${res.status}`);
|
|
531
|
+
if ([401, 403, 429, 0].includes(res.status)) break;
|
|
532
|
+
continue;
|
|
533
|
+
}
|
|
534
|
+
if (!res.body || typeof res.body !== "object") { drops.details_failed++; stopReason = "invalid_response"; continue; }
|
|
535
|
+
const details = res.body || {};
|
|
536
|
+
const name = details.displayName?.text || place.name;
|
|
537
|
+
const types = [details.primaryType || "", ...(details.types || [])];
|
|
538
|
+
const categoryHaystack = [name, ...types].join(" ").toLowerCase();
|
|
539
|
+
if (excludeCategories.some((t) => categoryHaystack.includes(t))) {
|
|
540
|
+
drops.category += 1;
|
|
541
|
+
pendingPlaces.delete(place.place_id);
|
|
542
|
+
if (verbose) console.error(`Excluded by category: ${name}`);
|
|
543
|
+
continue;
|
|
544
|
+
}
|
|
545
|
+
const websiteUri = details.websiteUri || "";
|
|
546
|
+
if (!websiteUri) {
|
|
547
|
+
drops.no_website += 1;
|
|
548
|
+
pendingPlaces.delete(place.place_id);
|
|
549
|
+
if (verbose) console.error(`No website: ${name}`);
|
|
550
|
+
continue;
|
|
551
|
+
}
|
|
552
|
+
|
|
553
|
+
// Homepage + the two pages solo operators put their address/name on.
|
|
554
|
+
const pageUrls = [websiteUri];
|
|
555
|
+
try {
|
|
556
|
+
pageUrls.push(new URL("/contact", websiteUri).toString());
|
|
557
|
+
pageUrls.push(new URL("/about", websiteUri).toString());
|
|
558
|
+
} catch {}
|
|
559
|
+
const htmls = (await Promise.all(pageUrls.map((u) => fetchHtml(u, MAX_REDIRECTS, cfg.deadline)))).filter(
|
|
560
|
+
Boolean,
|
|
561
|
+
);
|
|
562
|
+
if (!htmls.length) {
|
|
563
|
+
drops.scrape_failed += 1;
|
|
564
|
+
stopReason = Date.now() >= cfg.deadline ? "time_budget" : "website_unavailable";
|
|
565
|
+
continue;
|
|
566
|
+
}
|
|
567
|
+
sitesScraped += 1;
|
|
568
|
+
|
|
569
|
+
const candidates = new Set();
|
|
570
|
+
for (const html of htmls) for (const e of extractEmails(html)) candidates.add(e);
|
|
571
|
+
emailsFound += candidates.size;
|
|
572
|
+
|
|
573
|
+
const picked = pickEmail([...candidates], toDomain(websiteUri), emailPreference);
|
|
574
|
+
pendingPlaces.delete(place.place_id);
|
|
575
|
+
if (!picked) {
|
|
576
|
+
drops.no_email += 1;
|
|
577
|
+
if (verbose) console.error(`No usable email: ${name} (${websiteUri})`);
|
|
578
|
+
continue;
|
|
579
|
+
}
|
|
580
|
+
if (seenEmails.has(picked.email)) {
|
|
581
|
+
drops.duplicate_email += 1;
|
|
582
|
+
continue;
|
|
583
|
+
}
|
|
584
|
+
seenEmails.add(picked.email);
|
|
585
|
+
|
|
586
|
+
const text = `${htmls.map(pageTitle).join(" ")} ${htmls
|
|
587
|
+
.map(htmlToText)
|
|
588
|
+
.join(" ")}`;
|
|
589
|
+
const { city, state, country } = parseAddress(
|
|
590
|
+
details.formattedAddress || place.address,
|
|
591
|
+
);
|
|
592
|
+
leads.push({
|
|
593
|
+
email: picked.email,
|
|
594
|
+
first_name: "",
|
|
595
|
+
last_name: "",
|
|
596
|
+
company_name: name,
|
|
597
|
+
website: toDomain(websiteUri),
|
|
598
|
+
title: "",
|
|
599
|
+
seniority: "",
|
|
600
|
+
linkedin_url: "",
|
|
601
|
+
city,
|
|
602
|
+
state,
|
|
603
|
+
country,
|
|
604
|
+
industry: details.primaryType || "",
|
|
605
|
+
company_size: null,
|
|
606
|
+
email_status: "unverified",
|
|
607
|
+
apollo_id: "",
|
|
608
|
+
// Extended fields (ignored by Instantly, useful for analytics)
|
|
609
|
+
place_id: place.place_id,
|
|
610
|
+
phone: details.nationalPhoneNumber || "",
|
|
611
|
+
email_kind: picked.kind,
|
|
612
|
+
email_selection: `${emailPreference}_heuristic`,
|
|
613
|
+
name_candidate: extractOwnerFirstName(text, name),
|
|
614
|
+
name_candidate_source: "page_text_english_heuristic",
|
|
615
|
+
website_url: websiteUri,
|
|
616
|
+
address_source: "formatted_address_heuristic",
|
|
617
|
+
});
|
|
618
|
+
if (verbose) console.error(`Lead: ${picked.email} (${picked.kind}) — ${name}`);
|
|
619
|
+
} catch (e) {
|
|
620
|
+
drops.details_failed += 1;
|
|
621
|
+
stopReason = Date.now() >= cfg.deadline ? "time_budget" : "network_error";
|
|
622
|
+
console.error(`Place ${place.place_id} failed: ${e.message}`);
|
|
623
|
+
} finally {
|
|
624
|
+
checkpoint();
|
|
625
|
+
}
|
|
626
|
+
}
|
|
627
|
+
result.meta.complete = pendingQueries.size === 0 && pendingPlaces.size === 0;
|
|
628
|
+
result.meta.stop_reason = result.meta.complete ? (places.size >= maxPlaces ? "max_places" : "completed") : stopReason || "incomplete";
|
|
629
|
+
checkpoint();
|
|
630
|
+
|
|
631
|
+
const dropSummary = Object.entries(drops)
|
|
632
|
+
.map(([k, v]) => `${k}=${v}`)
|
|
633
|
+
.join(" ");
|
|
634
|
+
console.error(
|
|
635
|
+
`Summary: ${places.size} places seen, ${sitesScraped} sites scraped, ` +
|
|
636
|
+
`${emailsFound} emails found, ${leads.length} leads emitted. Drops: ${dropSummary}`,
|
|
637
|
+
);
|
|
638
|
+
|
|
639
|
+
if (outputPath) {
|
|
640
|
+
writeJson(outputPath, result);
|
|
641
|
+
console.error(`Wrote ${leads.length} leads to ${outputPath}`);
|
|
642
|
+
} else {
|
|
643
|
+
console.log(JSON.stringify(result, null, 2));
|
|
644
|
+
}
|
|
645
|
+
process.exitCode = result.meta.complete ? 0 : 2;
|
|
646
|
+
}
|
|
647
|
+
|
|
648
|
+
if (require.main === module) main().catch((e) => {
|
|
649
|
+
console.error(e);
|
|
650
|
+
process.exit(1);
|
|
651
|
+
});
|
|
652
|
+
|
|
653
|
+
module.exports = { isGlobalIp, resolvePublicAddress, fetchHtml, extractEmails, pickEmail };
|