AGENT SKILL

apify-install-auth

Install and configure Apify SDK, CLI, and API client authentication. Use when setting up a new Apify project, configuring API tokens, or initializing apify-client / Apify SDK in your codebase. Trigger: "install apify", "setup apify", "apify auth", "configure apify token".

License 许可
MIT
最近更新
2026-07-13
Stars
★ 1
Forks
0

01 前言 Front Matter

name
apify-install-auth
tags
[ "saas", "scraping", "automation", "apify" ]
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
version
1.0.0
description
Install and configure Apify SDK, CLI, and API client authentication. Use when setting up a new Apify project, configuring API tokens, or initializing apify-client / Apify SDK in your codebase. Trigger: "install apify", "setup apify", "apify auth", "configure apify token".
allowed-tools
Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(apify:*), Grep
compatible-with
claude-code

03 SKILL.md 正文

Apify Install & Auth

Overview

Set up the Apify ecosystem: the apify-client JS library (for calling Actors remotely), the apify SDK (for building Actors), the Apify CLI (for deploying), and Crawlee (for crawling). Each package serves a different purpose.

Package Map

Package npm Purpose
apify-client npm i apify-client Call Actors, manage datasets/KV stores from external apps
apify npm i apify Build Actors (includes Actor.init(), Actor.pushData())
crawlee npm i crawlee Crawler framework (Cheerio, Playwright, Puppeteer crawlers)
apify-cli npm i -g apify-cli CLI for apify login, apify run, apify push

Prerequisites

  • Node.js 18+ (required by SDK v3+)
  • Apify account at https://console.apify.com
  • API token from Settings > Integrations in Apify Console

Instructions

Step 1: Install Packages

# For CALLING existing Actors from your app:
npm install apify-client

# For BUILDING your own Actors:
npm install apify crawlee

# For CLI deployment:
npm install -g apify-cli

Step 2: Configure Authentication

# Option A: Environment variable (recommended for apps)
export APIFY_TOKEN="apify_api_YOUR_TOKEN_HERE"

# Option B: .env file (add .env to .gitignore)
echo 'APIFY_TOKEN=apify_api_YOUR_TOKEN_HERE' >> .env

# Option C: CLI login (for interactive development)
apify login
# Paste your token when prompted

Step 3: Verify Connection

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({
  token: process.env.APIFY_TOKEN,
});

// List your Actors to confirm auth works
const { items } = await client.actors().list();
console.log(`Authenticated. You have ${items.length} Actors.`);

Step 4: Verify CLI (if installed)

apify login --token YOUR_TOKEN
apify info  # Shows your account info

Auth Token Details

  • Token format: apify_api_ prefix followed by alphanumeric string
  • Pass via Authorization: Bearer <token> header (REST API)
  • Pass via token constructor option (JS client)
  • The APIFY_TOKEN env var is auto-detected by both apify-client and apify SDK

Environment Variable Reference

Variable Purpose
APIFY_TOKEN API authentication (primary)
APIFY_PROXY_PASSWORD Proxy access (auto-set on platform)
APIFY_IS_AT_HOME true when running on Apify platform
APIFY_DEFAULT_DATASET_ID Default dataset for current run
APIFY_DEFAULT_KEY_VALUE_STORE_ID Default KV store for current run
APIFY_DEFAULT_REQUEST_QUEUE_ID Default request queue for current run

Error Handling

Error Cause Solution
401 Unauthorized Invalid or expired token Regenerate token in Console > Settings > Integrations
Cannot find module 'apify-client' Package not installed npm install apify-client
APIFY_TOKEN is not set Missing env var Export APIFY_TOKEN or pass token to constructor
apify: command not found CLI not installed globally npm install -g apify-cli

Examples

TypeScript Project Setup

// src/apify/client.ts
import { ApifyClient } from 'apify-client';
import 'dotenv/config'; // npm install dotenv

let client: ApifyClient | null = null;

export function getClient(): ApifyClient {
  if (!client) {
    if (!process.env.APIFY_TOKEN) {
      throw new Error('APIFY_TOKEN environment variable is required');
    }
    client = new ApifyClient({ token: process.env.APIFY_TOKEN });
  }
  return client;
}

.env.example Template

# Apify — get your token at https://console.apify.com/account/integrations
APIFY_TOKEN=apify_api_REPLACE_ME

Resources

Next Steps

Proceed to apify-hello-world for your first Actor call.

04 同仓库更多 Skills

jukeyman
jukeyman/jukeyman-skills

zustand-store-creator

Create zustand store creator operations. Auto-activating skill for Frontend Development. Triggers on: zustand store creator, zustand store creator Part of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like "zustand store creator", "zustand creator", "zustand".

★ 1
jukeyman
jukeyman/jukeyman-skills

zero-trust-config-helper

Configure with zero trust config helper operations. Auto-activating skill for Security Advanced. Triggers on: zero trust config helper, zero trust config helper Part of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like "zero trust config helper", "zero helper", "zero".

★ 1
jukeyman
jukeyman/jukeyman-skills

zapier-integration-helper

Assist with zapier integration helper operations. Auto-activating skill for Business Automation. Triggers on: zapier integration helper, zapier integration helper Part of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like "zapier integration helper", "zapier helper", "zapier".

★ 1
jukeyman
jukeyman/jukeyman-skills

yaml-config-validator

Validate yaml config validator operations. Auto-activating skill for DevOps Basics. Triggers on: yaml config validator, yaml config validator Part of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like "yaml config validator", "yaml validator", "yaml".

★ 1
jukeyman
jukeyman/jukeyman-skills

xvary-stock-research

Thesis-driven equity analysis from public SEC EDGAR and market data; /analyze, /score, /compare workflows with bundled Python tools (Claude Code, Cursor, Codex).

★ 1
jukeyman
jukeyman/jukeyman-skills

xss-vulnerability-scanner

Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals. Triggers on: xss vulnerability scanner, xss vulnerability scanner Part of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like "xss vulnerability scanner", "xss scanner", "xss".

★ 1