/setup-typefully.en

description: "Lesson command"
duration: "~10 min"
prerequisites: ["Have an X (Twitter) account", "Browser available"]
level: "beginner"
tags: ["setup", "typefully", "api", "sns"]
nonInteractiveMode: incompatible

Typefully API Setup

Step 0: Check Setup Progress

**What the AI auto-runs:** 1. Run `uv run python tools/setup_progress.py show --current setup-typefully` to display progress 2. Auto-detect existing API key:

• Run `uv run python tools/credential_manager.py status`
• If TYPEFULLY_API_KEY is already set, only run Step 4 (API test) and mark as complete
• If it exists in plaintext in `.env`, suggest migration to the credential store

> **This setup is optional.** The Typefully API is used in marketing lessons (Module 12) for scheduling SNS posts. You can skip it if you're not taking marketing lessons.

What You'll Do in This Session

| Item | Details | |------|---------| | Goal | Obtain a Typefully API key, save it to the Credential Store, and enable SNS post scheduling and management features | | Duration | ~10 minutes | | Prerequisites | Have an X (Twitter) account, browser available | | Skill Level | Mostly AI auto-run (only one manual command in a separate terminal for API key storage) |

**What is Typefully:** Typefully is a service for scheduling and managing SNS posts on X (Twitter), LinkedIn, and more. You can post AI-generated content directly. Free plan available. Paid plans start at $12.5/month.

**Session flow:** 1. Open Typefully in the browser (AI auto-launches browser) 2. Sign up / log in with X (Twitter) account 3. Obtain the API key (just copy from the settings page) 4. Securely save the API key with credential_manager.py (run in separate terminal) 5. Operation test (AI auto-runs)

> **Hint**: If the AI stops responding midway, type "please continue" or "it stopped" to resume.

---

Readiness Check

**AskQuestion configuration:**

{
  "title": "Pre-session confirmation",
  "questions": [{
    "id": "readiness",
    "prompt": "Are you ready?",
    "options": [
      {"id": "ready", "label": "Ready! Let's start"},
      {"id": "chrome", "label": "Automate browser operations with /chrome"},
      {"id": "check_prereq", "label": "I want to check the prerequisites"},
      {"id": "skip", "label": "I want to skip this setup"},
      {"id": "different_lesson", "label": "Go to a different lesson"}
    ]
  }]
}

(ready -> Proceed to Step 1) (chrome -> After opening the browser in Step 1, follow the "Chrome integration automation" section) (check_prereq -> Guide: "You're good to go if you can log in to your X (Twitter) account in a browser. Typefully has a free plan so there's no cost") (skip -> Guide: "Typefully API setup skipped. You can set it up later with /setup-typefully when needed" and end) (different_lesson -> Show module list)

---

Step 1: Open Typefully in the Browser

**What the AI does:** 1. Auto-detect the OS (Mac / Windows / Linux) 2. Run the following command to auto-launch the browser:

# Mac:
open https://typefully.com
# Windows:
start https://typefully.com
# Linux:
xdg-open https://typefully.com

**Once the browser opens, display the following AskQuestion:**

{
  "title": "Step 1: Sign Up / Log In to Typefully",
  "questions": [{
    "id": "browser_status",
    "prompt": "Did the browser open? Follow these steps to sign up:\n\n1. Click 'Get started free' on the Typefully top page\n2. Select 'Sign up with X (Twitter)' to authenticate with your X account\n3. Once the Typefully dashboard appears, sign-up is complete\n\nWere you able to sign up?",
    "options": [
      {"id": "signed_up", "label": "Signed up / logged in!"},
      {"id": "already_account", "label": "I already have an account"},
      {"id": "browser_not_open", "label": "The browser didn't open"},
      {"id": "x_auth_issue", "label": "Authentication with X account isn't working"}
    ]
  }]
}

(signed_up -> Proceed to Step 2) (already_account -> Proceed to Step 2) (browser_not_open -> Guide: "Please open this URL directly in your browser: https://typefully.com") (x_auth_issue -> Guide: "If authentication with your X account is blocked, enable third-party app access in X's privacy settings. Go to X -> Settings -> Security and account access -> Apps and sessions to check")

---

Chrome Integration Automation (`/chrome` mode)

**Prerequisites:** The "Claude in Chrome" extension (v1.0.36+) is installed in Chrome, and you launched with `claude --chrome` or ran `/chrome` within the session.

**What the AI auto-runs via Chrome integration:** 1. Open https://typefully.com in the browser 2. Use Chrome integration to sequentially perform:

• Click "Get started free"
• Authenticate with "Sign up with X (Twitter)" (wait for user action)
• After login, navigate to https://typefully.com/settings/api
• Click "Generate API Key" or "Create API Key"

3. Once the API key is displayed, prompt the user: "Please copy the API key" 4. Proceed to Step 3

**Note:** Do not read the API key value from the browser screen. The user copies it manually.

If Chrome integration is not available, follow the manual steps below.

---

Step 2: Obtain the API Key

**What the AI does:** 1. Run the following command to open the API settings page in the browser:

# Mac:
open https://typefully.com/settings/api
# Windows:
start https://typefully.com/settings/api
# Linux:
xdg-open https://typefully.com/settings/api

**Once the browser opens, display the following AskQuestion:**

{
  "title": "Step 2: Obtain API Key",
  "questions": [{
    "id": "api_key_status",
    "prompt": "Did the API settings page open? Follow these steps to obtain the API key:\n\n1. Go to the Typefully Settings > API page\n2. If an API key is displayed, copy it as-is\n3. If you need to create a new one, click 'Generate API Key'\n4. Copy the displayed API key\n\nWere you able to copy the API key?",
    "options": [
      {"id": "copied", "label": "API key copied!"},