[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78X4XVS8SQSX0Z1AC5WZXAX":3,"skill-same:01M78X4XVS8SQSX0Z1AC5WZXAX":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":40,"ownerDescription":41,"updatedAt":42,"install":43,"resources":56},"01M78X4XVS8SQSX0Z1AC5WZXAX","apify-reference-architecture",null,"Production-grade architecture patterns for Apify-powered applications.\nUse when designing scraping infrastructure, building multi-Actor pipelines,\nor integrating Apify into a larger system architecture.\nTrigger: \"apify architecture\", \"apify best practices\",\n\"apify project structure\", \"scraping architecture\", \"apify system design\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--apify-pack--apify-reference-architecture\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: apify-reference-architecture\ndescription: |\n  Production-grade architecture patterns for Apify-powered applications.\n  Use when designing scraping infrastructure, building multi-Actor pipelines,\n  or integrating Apify into a larger system architecture.\n  Trigger: \"apify architecture\", \"apify best practices\",\n  \"apify project structure\", \"scraping architecture\", \"apify system design\".\nallowed-tools: Read, Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ntags: [saas, scraping, automation, apify]\ncompatible-with: claude-code\n---\n\n# Apify Reference Architecture\n\n## Overview\n\nProduction-ready architecture patterns for applications built on Apify. Covers standalone Actor projects, multi-Actor pipelines, and full-stack applications that integrate Apify as a data source.\n\n## Architecture Pattern 1: Standalone Actor\n\nFor a single scraper deployed to Apify platform.\n\n```\nmy-scraper\u002F\n├── .actor\u002F\n│   ├── actor.json           # Actor metadata\n│   ├── INPUT_SCHEMA.json    # Input definition (generates UI)\n│   └── Dockerfile           # Build configuration\n├── src\u002F\n│   ├── main.ts              # Entry point (Actor.main)\n│   ├── routes\u002F\n│   │   ├── listing.ts       # Router handler: listing pages\n│   │   └── detail.ts        # Router handler: detail pages\n│   ├── types.ts             # Input\u002Foutput TypeScript types\n│   └── utils\u002F\n│       ├── extractors.ts    # Data extraction functions\n│       └── validators.ts    # Input\u002Foutput validation\n├── tests\u002F\n│   ├── extractors.test.ts   # Unit tests for extraction logic\n│   └── integration.test.ts  # Integration tests (live API)\n├── storage\u002F                  # Local storage (git-ignored)\n├── package.json\n├── tsconfig.json\n└── .gitignore\n```\n\n### Key Files\n\n```typescript\n\u002F\u002F src\u002Fmain.ts — Actor entry point\nimport { Actor } from 'apify';\nimport { CheerioCrawler } from 'crawlee';\nimport { router } from '.\u002Froutes\u002Flisting';\nimport { validateInput, ScraperInput } from '.\u002Ftypes';\n\nawait Actor.main(async () => {\n  const rawInput = await Actor.getInput\u003CScraperInput>();\n  const input = validateInput(rawInput);\n\n  const proxyConfiguration = input.proxyConfig?.useApifyProxy\n    ? await Actor.createProxyConfiguration({ groups: input.proxyConfig.groups })\n    : undefined;\n\n  const crawler = new CheerioCrawler({\n    requestHandler: router,\n    proxyConfiguration,\n    maxRequestsPerCrawl: input.maxItems ?? 100,\n    maxConcurrency: input.concurrency ?? 10,\n  });\n\n  await crawler.run(input.startUrls.map(s => s.url));\n});\n```\n\n```typescript\n\u002F\u002F src\u002Ftypes.ts — Shared types and validation\nimport { z } from 'zod';\n\nexport const InputSchema = z.object({\n  startUrls: z.array(z.object({ url: z.string().url() })).min(1),\n  maxItems: z.number().int().positive().optional().default(100),\n  concurrency: z.number().int().min(1).max(50).optional().default(10),\n  proxyConfig: z.object({\n    useApifyProxy: z.boolean(),\n    groups: z.array(z.string()).optional(),\n  }).optional(),\n});\n\nexport type ScraperInput = z.infer\u003Ctypeof InputSchema>;\n\nexport function validateInput(raw: unknown): ScraperInput {\n  return InputSchema.parse(raw);\n}\n\nexport interface ProductOutput {\n  url: string;\n  name: string;\n  price: number | null;\n  currency: string;\n  inStock: boolean;\n  scrapedAt: string;\n}\n```\n\n## Architecture Pattern 2: Multi-Actor Pipeline\n\nFor complex scraping workflows with multiple stages.\n\n```\n┌──────────────┐     ┌──────────────┐     ┌──────────────┐\n│  Discover    │────▶│  Scrape      │────▶│  Transform   │\n│  Actor       │     │  Actor       │     │  Actor       │\n│              │     │              │     │              │\n│ Finds URLs   │     │ Extracts     │     │ Dedup,       │\n│ to scrape    │     │ raw data     │     │ clean,       │\n│              │     │              │     │ enrich       │\n└──────┬───────┘     └──────┬───────┘     └──────┬───────┘\n       │                    │                    │\n       ▼                    ▼                    ▼\n  Request Queue         Dataset A            Dataset B\n  (URLs to scrape)      (raw data)          (clean data)\n```\n\n### Pipeline Orchestrator\n\n```typescript\n\u002F\u002F pipeline\u002Forchestrator.ts\nimport { ApifyClient } from 'apify-client';\n\nconst client = new ApifyClient({ token: process.env.APIFY_TOKEN });\n\ninterface PipelineConfig {\n  discoverActorId: string;\n  scrapeActorId: string;\n  transformActorId: string;\n  seedUrls: string[];\n  maxItems: number;\n}\n\nasync function runPipeline(config: PipelineConfig) {\n  const results = {\n    discover: { runId: '', items: 0, cost: 0 },\n    scrape: { runId: '', items: 0, cost: 0 },\n    transform: { runId: '', items: 0, cost: 0 },\n  };\n\n  \u002F\u002F Stage 1: Discover URLs\n  console.log('Stage 1: Discovering URLs...');\n  const discoverRun = await client.actor(config.discoverActorId).call({\n    seedUrls: config.seedUrls,\n    maxPages: 50,\n  });\n  const { items: urls } = await client\n    .dataset(discoverRun.defaultDatasetId)\n    .listItems();\n  results.discover = {\n    runId: discoverRun.id,\n    items: urls.length,\n    cost: discoverRun.usageTotalUsd ?? 0,\n  };\n\n  \u002F\u002F Stage 2: Scrape each discovered URL\n  console.log(`Stage 2: Scraping ${urls.length} URLs...`);\n  const scrapeRun = await client.actor(config.scrapeActorId).call({\n    startUrls: urls.map((u: any) => ({ url: u.url })),\n    maxItems: config.maxItems,\n  });\n  results.scrape = {\n    runId: scrapeRun.id,\n    items: scrapeRun.stats?.datasetItemCount ?? 0,\n    cost: scrapeRun.usageTotalUsd ?? 0,\n  };\n\n  \u002F\u002F Stage 3: Transform and deduplicate\n  console.log('Stage 3: Transforming...');\n  const transformRun = await client.actor(config.transformActorId).call({\n    sourceDatasetId: scrapeRun.defaultDatasetId,\n    dedupField: 'url',\n    filterEmpty: true,\n  });\n  results.transform = {\n    runId: transformRun.id,\n    items: transformRun.stats?.datasetItemCount ?? 0,\n    cost: transformRun.usageTotalUsd ?? 0,\n  };\n\n  \u002F\u002F Store final results in named dataset\n  const finalDs = await client.datasets().getOrCreate('pipeline-output');\n  const { items: cleanData } = await client\n    .dataset(transformRun.defaultDatasetId)\n    .listItems();\n  await client.dataset(finalDs.id).pushItems(cleanData);\n\n  \u002F\u002F Summary\n  const totalCost = Object.values(results).reduce((s, r) => s + r.cost, 0);\n  console.log('\\n=== Pipeline Summary ===');\n  console.log(`Discovered: ${results.discover.items} URLs`);\n  console.log(`Scraped:    ${results.scrape.items} items`);\n  console.log(`Clean:      ${results.transform.items} items`);\n  console.log(`Total cost: $${totalCost.toFixed(4)}`);\n\n  return results;\n}\n```\n\n## Architecture Pattern 3: Full-Stack Integration\n\nApplication that uses Apify as a data source.\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                    Your Application                      │\n│                                                          │\n│  ┌─────────┐   ┌──────────────┐   ┌─────────────────┐  │\n│  │ Frontend │──▶│ API Server   │──▶│ Apify Service    │  │\n│  │ (React)  │   │ (Express\u002F    │   │ (apify-client)   │  │\n│  │          │◀──│  Next.js)    │◀──│                  │  │\n│  └─────────┘   └──────┬───────┘   └────────┬─────────┘  │\n│                       │                     │             │\n│                       ▼                     ▼             │\n│                 ┌──────────┐         ┌────────────┐      │\n│                 │ Your DB  │         │ Apify      │      │\n│                 │ (results)│         │ Platform   │      │\n│                 └──────────┘         └────────────┘      │\n│                                                          │\n│  ┌──────────────────────────────────────────────────┐   │\n│  │ Webhook Handler                                   │   │\n│  │ Receives run completion → saves results to DB     │   │\n│  └──────────────────────────────────────────────────┘   │\n└─────────────────────────────────────────────────────────┘\n```\n\n### Service Layer\n\n```typescript\n\u002F\u002F src\u002Fservices\u002Fapify-service.ts\nimport { ApifyClient } from 'apify-client';\n\nexport class ApifyService {\n  private client: ApifyClient;\n\n  constructor(token: string) {\n    this.client = new ApifyClient({ token });\n  }\n\n  async startScrape(urls: string[]): Promise\u003C{ runId: string }> {\n    const run = await this.client.actor('username\u002Fscraper').start({\n      startUrls: urls.map(url => ({ url })),\n    });\n    return { runId: run.id };\n  }\n\n  async getRunStatus(runId: string): Promise\u003C{\n    status: string;\n    progress?: { finished: number; failed: number };\n  }> {\n    const run = await this.client.run(runId).get();\n    return {\n      status: run.status,\n      progress: {\n        finished: run.stats?.requestsFinished ?? 0,\n        failed: run.stats?.requestsFailed ?? 0,\n      },\n    };\n  }\n\n  async getResults\u003CT>(runId: string): Promise\u003CT[]> {\n    const run = await this.client.run(runId).get();\n    if (run.status !== 'SUCCEEDED') {\n      throw new Error(`Run not ready: ${run.status}`);\n    }\n    const { items } = await this.client\n      .dataset(run.defaultDatasetId)\n      .listItems();\n    return items as T[];\n  }\n\n  async checkHealth(): Promise\u003Cboolean> {\n    try {\n      const user = await this.client.user().get();\n      return !!user.username;\n    } catch {\n      return false;\n    }\n  }\n}\n```\n\n## Configuration Management\n\n```typescript\n\u002F\u002F src\u002Fconfig\u002Fapify.ts\ninterface ApifyConfig {\n  token: string;\n  actorId: string;\n  defaultMemory: number;\n  defaultTimeout: number;\n  webhookUrl?: string;\n}\n\nexport function loadConfig(): ApifyConfig {\n  const env = process.env.NODE_ENV || 'development';\n\n  const base: ApifyConfig = {\n    token: process.env.APIFY_TOKEN!,\n    actorId: process.env.APIFY_ACTOR_ID!,\n    defaultMemory: 1024,\n    defaultTimeout: 3600,\n  };\n\n  const overrides: Record\u003Cstring, Partial\u003CApifyConfig>> = {\n    development: { defaultMemory: 256, defaultTimeout: 300 },\n    staging: { defaultMemory: 512 },\n    production: { webhookUrl: process.env.APIFY_WEBHOOK_URL },\n  };\n\n  return { ...base, ...overrides[env] };\n}\n```\n\n## Health Check\n\n```typescript\n\u002F\u002F src\u002Fhealth.ts\nexport async function healthCheck(apifyService: ApifyService) {\n  const start = Date.now();\n  const healthy = await apifyService.checkHealth();\n\n  return {\n    service: 'apify',\n    status: healthy ? 'healthy' : 'unhealthy',\n    latencyMs: Date.now() - start,\n    timestamp: new Date().toISOString(),\n  };\n}\n```\n\n## Error Handling\n\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| Circular dependencies | Service imports service | Use dependency injection |\n| Missing config | Env var not set | Validate at startup with `loadConfig()` |\n| Pipeline stage failure | Actor crash mid-pipeline | Add retry logic per stage |\n| State management | Tracking run status | Use webhook handler + database |\n\n## Resources\n\n- [Apify Platform Architecture](https:\u002F\u002Fdocs.apify.com\u002Fplatform)\n- [API Client Reference](https:\u002F\u002Fdocs.apify.com\u002Fapi\u002Fclient\u002Fjs\u002Freference)\n- [Actor Development Best Practices](https:\u002F\u002Fdocs.apify.com\u002Fplatform\u002Factors\u002Fdevelopment)\n\n## Flagship Skills\n\nFor multi-environment setup, see `apify-deploy-integration`.\n","# Apify Reference Architecture\n\n## Overview\n\nProduction-ready architecture patterns for applications built on Apify. Covers standalone Actor projects, multi-Actor pipelines, and full-stack applications that integrate Apify as a data source.\n\n## Architecture Pattern 1: Standalone Actor\n\nFor a single scraper deployed to Apify platform.\n\n```\nmy-scraper\u002F\n├── .actor\u002F\n│   ├── actor.json           # Actor metadata\n│   ├── INPUT_SCHEMA.json    # Input definition (generates UI)\n│   └── Dockerfile           # Build configuration\n├── src\u002F\n│   ├── main.ts              # Entry point (Actor.main)\n│   ├── routes\u002F\n│   │   ├── listing.ts       # Router handler: listing pages\n│   │   └── detail.ts        # Router handler: detail pages\n│   ├── types.ts             # Input\u002Foutput TypeScript types\n│   └── utils\u002F\n│       ├── extractors.ts    # Data extraction functions\n│       └── validators.ts    # Input\u002Foutput validation\n├── tests\u002F\n│   ├── extractors.test.ts   # Unit tests for extraction logic\n│   └── integration.test.ts  # Integration tests (live API)\n├── storage\u002F                  # Local storage (git-ignored)\n├── package.json\n├── tsconfig.json\n└── .gitignore\n```\n\n### Key Files\n\n```typescript\n\u002F\u002F src\u002Fmain.ts — Actor entry point\nimport { Actor } from 'apify';\nimport { CheerioCrawler } from 'crawlee';\nimport { router } from '.\u002Froutes\u002Flisting';\nimport { validateInput, ScraperInput } from '.\u002Ftypes';\n\nawait Actor.main(async () => {\n  const rawInput = await Actor.getInput\u003CScraperInput>();\n  const input = validateInput(rawInput);\n\n  const proxyConfiguration = input.proxyConfig?.useApifyProxy\n    ? await Actor.createProxyConfiguration({ groups: input.proxyConfig.groups })\n    : undefined;\n\n  const crawler = new CheerioCrawler({\n    requestHandler: router,\n    proxyConfiguration,\n    maxRequestsPerCrawl: input.maxItems ?? 100,\n    maxConcurrency: input.concurrency ?? 10,\n  });\n\n  await crawler.run(input.startUrls.map(s => s.url));\n});\n```\n\n```typescript\n\u002F\u002F src\u002Ftypes.ts — Shared types and validation\nimport { z } from 'zod';\n\nexport const InputSchema = z.object({\n  startUrls: z.array(z.object({ url: z.string().url() })).min(1),\n  maxItems: z.number().int().positive().optional().default(100),\n  concurrency: z.number().int().min(1).max(50).optional().default(10),\n  proxyConfig: z.object({\n    useApifyProxy: z.boolean(),\n    groups: z.array(z.string()).optional(),\n  }).optional(),\n});\n\nexport type ScraperInput = z.infer\u003Ctypeof InputSchema>;\n\nexport function validateInput(raw: unknown): ScraperInput {\n  return InputSchema.parse(raw);\n}\n\nexport interface ProductOutput {\n  url: string;\n  name: string;\n  price: number | null;\n  currency: string;\n  inStock: boolean;\n  scrapedAt: string;\n}\n```\n\n## Architecture Pattern 2: Multi-Actor Pipeline\n\nFor complex scraping workflows with multiple stages.\n\n```\n┌──────────────┐     ┌──────────────┐     ┌──────────────┐\n│  Discover    │────▶│  Scrape      │────▶│  Transform   │\n│  Actor       │     │  Actor       │     │  Actor       │\n│              │     │              │     │              │\n│ Finds URLs   │     │ Extracts     │     │ Dedup,       │\n│ to scrape    │     │ raw data     │     │ clean,       │\n│              │     │              │     │ enrich       │\n└──────┬───────┘     └──────┬───────┘     └──────┬───────┘\n       │                    │                    │\n       ▼                    ▼                    ▼\n  Request Queue         Dataset A            Dataset B\n  (URLs to scrape)      (raw data)          (clean data)\n```\n\n### Pipeline Orchestrator\n\n```typescript\n\u002F\u002F pipeline\u002Forchestrator.ts\nimport { ApifyClient } from 'apify-client';\n\nconst client = new ApifyClient({ token: process.env.APIFY_TOKEN });\n\ninterface PipelineConfig {\n  discoverActorId: string;\n  scrapeActorId: string;\n  transformActorId: string;\n  seedUrls: string[];\n  maxItems: number;\n}\n\nasync function runPipeline(config: PipelineConfig) {\n  const results = {\n    discover: { runId: '', items: 0, cost: 0 },\n    scrape: { runId: '', items: 0, cost: 0 },\n    transform: { runId: '', items: 0, cost: 0 },\n  };\n\n  \u002F\u002F Stage 1: Discover URLs\n  console.log('Stage 1: Discovering URLs...');\n  const discoverRun = await client.actor(config.discoverActorId).call({\n    seedUrls: config.seedUrls,\n    maxPages: 50,\n  });\n  const { items: urls } = await client\n    .dataset(discoverRun.defaultDatasetId)\n    .listItems();\n  results.discover = {\n    runId: discoverRun.id,\n    items: urls.length,\n    cost: discoverRun.usageTotalUsd ?? 0,\n  };\n\n  \u002F\u002F Stage 2: Scrape each discovered URL\n  console.log(`Stage 2: Scraping ${urls.length} URLs...`);\n  const scrapeRun = await client.actor(config.scrapeActorId).call({\n    startUrls: urls.map((u: any) => ({ url: u.url })),\n    maxItems: config.maxItems,\n  });\n  results.scrape = {\n    runId: scrapeRun.id,\n    items: scrapeRun.stats?.datasetItemCount ?? 0,\n    cost: scrapeRun.usageTotalUsd ?? 0,\n  };\n\n  \u002F\u002F Stage 3: Transform and deduplicate\n  console.log('Stage 3: Transforming...');\n  const transformRun = await client.actor(config.transformActorId).call({\n    sourceDatasetId: scrapeRun.defaultDatasetId,\n    dedupField: 'url',\n    filterEmpty: true,\n  });\n  results.transform = {\n    runId: transformRun.id,\n    items: transformRun.stats?.datasetItemCount ?? 0,\n    cost: transformRun.usageTotalUsd ?? 0,\n  };\n\n  \u002F\u002F Store final results in named dataset\n  const finalDs = await client.datasets().getOrCreate('pipeline-output');\n  const { items: cleanData } = await client\n    .dataset(transformRun.defaultDatasetId)\n    .listItems();\n  await client.dataset(finalDs.id).pushItems(cleanData);\n\n  \u002F\u002F Summary\n  const totalCost = Object.values(results).reduce((s, r) => s + r.cost, 0);\n  console.log('\\n=== Pipeline Summary ===');\n  console.log(`Discovered: ${results.discover.items} URLs`);\n  console.log(`Scraped:    ${results.scrape.items} items`);\n  console.log(`Clean:      ${results.transform.items} items`);\n  console.log(`Total cost: $${totalCost.toFixed(4)}`);\n\n  return results;\n}\n```\n\n## Architecture Pattern 3: Full-Stack Integration\n\nApplication that uses Apify as a data source.\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                    Your Application                      │\n│                                                          │\n│  ┌─────────┐   ┌──────────────┐   ┌─────────────────┐  │\n│  │ Frontend │──▶│ API Server   │──▶│ Apify Service    │  │\n│  │ (React)  │   │ (Express\u002F    │   │ (apify-client)   │  │\n│  │          │◀──│  Next.js)    │◀──│                  │  │\n│  └─────────┘   └──────┬───────┘   └────────┬─────────┘  │\n│                       │                     │             │\n│                       ▼                     ▼             │\n│                 ┌──────────┐         ┌────────────┐      │\n│                 │ Your DB  │         │ Apify      │      │\n│                 │ (results)│         │ Platform   │      │\n│                 └──────────┘         └────────────┘      │\n│                                                          │\n│  ┌──────────────────────────────────────────────────┐   │\n│  │ Webhook Handler                                   │   │\n│  │ Receives run completion → saves results to DB     │   │\n│  └──────────────────────────────────────────────────┘   │\n└─────────────────────────────────────────────────────────┘\n```\n\n### Service Layer\n\n```typescript\n\u002F\u002F src\u002Fservices\u002Fapify-service.ts\nimport { ApifyClient } from 'apify-client';\n\nexport class ApifyService {\n  private client: ApifyClient;\n\n  constructor(token: string) {\n    this.client = new ApifyClient({ token });\n  }\n\n  async startScrape(urls: string[]): Promise\u003C{ runId: string }> {\n    const run = await this.client.actor('username\u002Fscraper').start({\n      startUrls: urls.map(url => ({ url })),\n    });\n    return { runId: run.id };\n  }\n\n  async getRunStatus(runId: string): Promise\u003C{\n    status: string;\n    progress?: { finished: number; failed: number };\n  }> {\n    const run = await this.client.run(runId).get();\n    return {\n      status: run.status,\n      progress: {\n        finished: run.stats?.requestsFinished ?? 0,\n        failed: run.stats?.requestsFailed ?? 0,\n      },\n    };\n  }\n\n  async getResults\u003CT>(runId: string): Promise\u003CT[]> {\n    const run = await this.client.run(runId).get();\n    if (run.status !== 'SUCCEEDED') {\n      throw new Error(`Run not ready: ${run.status}`);\n    }\n    const { items } = await this.client\n      .dataset(run.defaultDatasetId)\n      .listItems();\n    return items as T[];\n  }\n\n  async checkHealth(): Promise\u003Cboolean> {\n    try {\n      const user = await this.client.user().get();\n      return !!user.username;\n    } catch {\n      return false;\n    }\n  }\n}\n```\n\n## Configuration Management\n\n```typescript\n\u002F\u002F src\u002Fconfig\u002Fapify.ts\ninterface ApifyConfig {\n  token: string;\n  actorId: string;\n  defaultMemory: number;\n  defaultTimeout: number;\n  webhookUrl?: string;\n}\n\nexport function loadConfig(): ApifyConfig {\n  const env = process.env.NODE_ENV || 'development';\n\n  const base: ApifyConfig = {\n    token: process.env.APIFY_TOKEN!,\n    actorId: process.env.APIFY_ACTOR_ID!,\n    defaultMemory: 1024,\n    defaultTimeout: 3600,\n  };\n\n  const overrides: Record\u003Cstring, Partial\u003CApifyConfig>> = {\n    development: { defaultMemory: 256, defaultTimeout: 300 },\n    staging: { defaultMemory: 512 },\n    production: { webhookUrl: process.env.APIFY_WEBHOOK_URL },\n  };\n\n  return { ...base, ...overrides[env] };\n}\n```\n\n## Health Check\n\n```typescript\n\u002F\u002F src\u002Fhealth.ts\nexport async function healthCheck(apifyService: ApifyService) {\n  const start = Date.now();\n  const healthy = await apifyService.checkHealth();\n\n  return {\n    service: 'apify',\n    status: healthy ? 'healthy' : 'unhealthy',\n    latencyMs: Date.now() - start,\n    timestamp: new Date().toISOString(),\n  };\n}\n```\n\n## Error Handling\n\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| Circular dependencies | Service imports service | Use dependency injection |\n| Missing config | Env var not set | Validate at startup with `loadConfig()` |\n| Pipeline stage failure | Actor crash mid-pipeline | Add retry logic per stage |\n| State management | Tracking run status | Use webhook handler + database |\n\n## Resources\n\n- [Apify Platform Architecture](https:\u002F\u002Fdocs.apify.com\u002Fplatform)\n- [API Client Reference](https:\u002F\u002Fdocs.apify.com\u002Fapi\u002Fclient\u002Fjs\u002Freference)\n- [Actor Development Best Practices](https:\u002F\u002Fdocs.apify.com\u002Fplatform\u002Factors\u002Fdevelopment)\n\n## Flagship Skills\n\nFor multi-environment setup, see `apify-deploy-integration`.\n",{"name":5,"tags":24,"author":29,"license":15,"version":30,"description":31,"allowed-tools":32,"compatible-with":33},[25,26,27,28],"saas","scraping","automation","apify","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Production-grade architecture patterns for Apify-powered applications.\nUse when designing scraping infrastructure, building multi-Actor pipelines,\nor integrating Apify into a larger system architecture.\nTrigger: \"apify architecture\", \"apify best practices\",\n\"apify project structure\", \"scraping architecture\", \"apify system design\".\n","Read, Grep","claude-code","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--apify-pack--apify-reference-architecture",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill apify-reference-architecture",{"tool":49,"command":50},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill apify-reference-architecture",{"tool":52,"command":53},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill apify-reference-architecture","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--apify-pack--apify-reference-architecture\u002FSKILL.md",true,[],[58,65,72,79,86,94],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":90,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]