Communitygithub.com

ComeOnOliver/skillshub

使用 OAuth 2.0 配置 AppFolio Stack API 認證。在設定物業管理 API 存取、註冊為 AppFolio Stack 合作夥伴或配置用戶端憑證以進行 API 呼叫時使用。

skillshub 是什麼?

這個技能為 AppFolio Stack API 配置 HTTP Basic Auth 認證,讓開發者能從頭開始設定 AppFolio 物業管理 API 的存取權限。使用者需先申請 AppFolio Stack 合作夥伴帳戶以取得 client ID 和 client secret,然後將這些認證資訊儲存在 `.env` 檔案中,並建立一個 TypeScript 或 Python 客戶端來處理所有 API 呼叫。此技能支援 Node.js 18+ 和 Python 3.10+,並包含驗證連線的步驟,以及常見錯誤(如 401、403、404 和連線逾時)的處理指引。它也提供了完整的 API 端點參考表(包括物業、單位、租戶、租約等),並引導使用者進行下一步,例如查詢第一個物業。這個技能在 AppFolio Stack 合作生態系統中特別有用,因為官方沒有公開的 npm SDK,必須使用直接 REST API 呼叫。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/jeremylongshore/claude-code-plugins-plus-skills/appfolio-install-auth

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

AppFolio 安裝與認證

概覽

配置 AppFolio Stack API 認證。AppFolio 使用 HTTP 基本認證,搭配客戶端 ID 和客戶端密碼,透過其 Stack 合作夥伴計劃提供。沒有公開的 npm SDK — 請使用直接的 REST API 呼叫。

先決條件

  • AppFolio Stack 合作夥伴帳戶 (appfolio.com/stack)
  • 來自 AppFolio 的客戶端 ID 和客戶端密碼
  • Node.js 18+ 或 Python 3.10+

步驟說明

步驟 1:取得 API 憑證

# AppFolio Stack API 憑證來自合作夥伴計劃
# 1. 於 appfolio.com/stack/become-a-partner 提出申請
# 2. 完成整合審查
# 3. 接收 client_id 和 client_secret

cat > .env << 'ENVFILE'
APPFOLIO_CLIENT_ID=你的客戶端ID
APPFOLIO_CLIENT_SECRET=你的客戶端密碼
APPFOLIO_BASE_URL=https://你的公司.appfolio.com/api/v1
ENVFILE

chmod 600 .env
echo ".env" >> .gitignore

步驟 2:建立 API 客戶端

// src/appfolio-client.ts
import axios, { AxiosInstance } from 'axios';

class AppFolioClient {
  private api: AxiosInstance;

  constructor() {
    this.api = axios.create({
      baseURL: process.env.APPFOLIO_BASE_URL,
      auth: {
        username: process.env.APPFOLIO_CLIENT_ID!,
        password: process.env.APPFOLIO_CLIENT_SECRET!,
      },
      headers: { 'Content-Type': 'application/json' },
      timeout: 30000,
    });
  }

  async verifyConnection(): Promise<boolean> {
    try {
      const response = await this.api.get('/properties');
      console.log(`連線成功!找到 ${response.data.length} 個物業`);
      return true;
    } catch (error: any) {
      console.error(`連線失敗:${error.response?.status} ${error.message}`);
      return false;
    }
  }

  get http(): AxiosInstance { return this.api; }
}

export { AppFolioClient };

步驟 3:驗證連線

# 快速 curl 測試
curl -u "${APPFOLIO_CLIENT_ID}:${APPFOLIO_CLIENT_SECRET}" \
  "${APPFOLIO_BASE_URL}/properties" | jq '.[0]'

API 端點

資源端點方法
物業/api/v1/propertiesGET
單位/api/v1/unitsGET
租戶/api/v1/tenantsGET
租約/api/v1/leasesGET, POST
帳單/api/v1/billsGET, POST
供應商/api/v1/vendorsGET
業主/api/v1/ownersGET
報表/api/v1/reportsGET

輸出結果

  • API 憑證配置在 .env 檔案中
  • 具備基本認證的 TypeScript REST 客戶端
  • 已驗證與 AppFolio API 的連線

錯誤處理

錯誤原因解決方案
401 Unauthorized憑證無效從 AppFolio 驗證 client_id/secret
403 Forbidden不是 Stack 合作夥伴完成合作夥伴申請
404 Not Found錯誤的基礎 URL使用 你的公司.appfolio.com 格式
逾時網路問題檢查防火牆是否允許 HTTPS 連線到 appfolio.com

資源

下一步

繼續進行 appfolio-hello-world,開始你的第一個物業查詢。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相關技能