Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

AppFolio Stack API の OAuth 2.0 認証を構成します。物件管理APIへのアクセス設定、AppFolio Stack パートナー登録、またはAPI呼び出し用のクライアント資格情報の構成時に使用します。トリガー: "install appfolio", "setup appfolio", "appfolio auth", "appfolio API key"。

tons-of-skills-marketplace とは?

このスキルは、AppFolio Stack API の認証設定を支援する専用ツールです。AppFolio は HTTP Basic 認証方式を採用しており、パートナープログラムを通じて発行されるクライアントIDとクライアントシークレットを必要とします。Node.js および Python 環境に対応し、axios を用いた TypeScript REST クライアントのひな形を提供します。資格情報の安全な取得、環境変数の設定、接続確認用の redacted curl コマンドを備え、401 認証エラーや 403 アクセス拒否などのエラーハンドリングも網羅。初回認証時はサンドボックス環境での読み取り専用テストを推奨し、本番書き込み前に構成の検証を徹底します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/plugins/saas-packs/appfolio-pack/skills/appfolio-install-auth

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

AppFolio インストールと認証

概要

AppFolio Stack API の認証を構成します。AppFolio は HTTP Basic Auth を使用し、Stack パートナープログラムを通じて発行されるクライアントIDとクライアントシークレットが必要です。公開 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. 提供元から発行されたベースURLと資格情報の受け取り手順を受領
# 値を承認済みのシークレットマネージャーに保存してください。ローカル開発用のテンプレートが必要な場合のみ、以下の非機密テンプレートをコミットします:
cat > .env.example << 'ENVFILE'
APPFOLIO_CLIENT_ID=
APPFOLIO_CLIENT_SECRET=
APPFOLIO_BASE_URL=
ENVFILE

# .env は無視されたままになります。承認されたローカルシークレットフローを通じてのみ設定してください。

ステップ 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: 接続の確認

# argv に Basic Auth を載せずに、簡潔かつ編集された診断を実行
NETRC_FILE="$(mktemp)"
trap 'rm -f "$NETRC_FILE"' EXIT
chmod 600 "$NETRC_FILE"
APPFOLIO_HOST="${APPFOLIO_BASE_URL#https://}"
APPFOLIO_HOST="${APPFOLIO_HOST%%/*}"
printf 'machine %s login %s password %s\n' "$APPFOLIO_HOST" \
  "$APPFOLIO_CLIENT_ID" "$APPFOLIO_CLIENT_SECRET" > "$NETRC_FILE"
curl -s -o /dev/null -w '%{http_code}\n' --netrc-file "$NETRC_FILE" \
  "${APPFOLIO_BASE_URL}/properties"

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

出力

  • 承認済みのシークレット境界を通じて注入された提供元発行の資格情報
  • Basic Auth を使用した TypeScript REST クライアント
  • 承認された安全な読み取りエンドポイントへの編集された接続結果

例

初めての認証リハーサルでは、サンドボックス資格情報と提供元発行のベースURLをローカルシークレット機構を通じて注入し、承認された合成物件ページへの読み取り専用リクエストを1回送信してください。ステータスコードとクライアント構成の判定のみを記録し、物件ペイロード、クライアントID、シークレット、完全なホスト/パスを共有ログに出力しないでください。契約、ベースURL、シークレットバインディング、またはステータス結果が未検証の場合は、書き込みワークフロー前に停止し、資格情報の所有者に構成を修正してもらってください。

エラーハンドリング

エラー原因解決策
401 Unauthorized無効な資格情報AppFolio からクライアントID/シークレットを確認
403 ForbiddenStack パートナーでないパートナー申請を完了
404 Not FoundベースURLが間違っているyour-company.appfolio.com 形式を使用
タイムアウトネットワークの問題ファイアウォールが appfolio.com への HTTPS を許可しているか確認

リソース

次のステップ

最初の物件クエリのために appfolio-hello-world に進んでください。

Individual skills in this repo

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

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page for positioning, plan a conversion-optimized page layout, or design a launch page. Examples: "landing page for product launch", "conversion-optimized layout for SaaS

jeremylongshore/tons-of-skills-marketplace

Use when asked to design growth-optimized landing pages, activation funnel layouts, or experiment-friendly page structures. Examples: "growth-optimized landing", "activation funnel layout", "A/B testable page

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page, design page layout for conversion, or plan landing page information architecture. Examples: "landing page structure for SaaS", "conversion-optimized layout

jeremylongshore/tons-of-skills-marketplace

Generate polished demo videos from a single prompt. Use when the user asks to create a demo video, product walkthrough, feature showcase, or animated presentation. Trigger with "make a demo video", "create a product video", "demo walkthrough", or "feature showcase video".

jeremylongshore/tons-of-skills-marketplace

Track cryptocurrency portfolio with real-time valuations, allocation analysis, and P&L tracking. Use when checking portfolio value, viewing holdings breakdown, analyzing allocations, or exporting portfolio data. Trigger with phrases like "show my portfolio", "check crypto holdings", "portfolio allocation", "track my crypto", or "export portfolio".

jeremylongshore/tons-of-skills-marketplace

Runs the full release workflow for the current project. Commits any uncommitted changes, pushes to remote, creates and merges a PR if on a feature branch, determines the next semver version from conventional commits, creates an annotated git tag and GitHub release with generated notes, cleans up merged branches, and returns to a clean main. Use when the user says promote, ship, release, commit and push, tag and release, or get back to main.

jeremylongshore/tons-of-skills-marketplace

Agent skill at plugins/productivity/content-multiplier/skills/channel-formats/SKILL.md

jeremylongshore/tons-of-skills-marketplace

Operate an evidence-backed editorial queue, balance topic and format coverage, schedule approved drafts, and reconcile backlog state with the publishing system. Use when choosing or scheduling the next blog work. Trigger with "show the editorial calendar" or "pick the next topic".

jeremylongshore/tons-of-skills-marketplace

Configure CI/CD pipeline for AppFolio property management integrations. Trigger: "appfolio CI".

jeremylongshore/tons-of-skills-marketplace

Diagnose and fix common AppFolio API integration errors. Trigger: "appfolio error".

jeremylongshore/tons-of-skills-marketplace

Build property management dashboard with AppFolio API data. Trigger: "appfolio property dashboard".

jeremylongshore/tons-of-skills-marketplace

Automate tenant management and lease operations with AppFolio. Trigger: "appfolio tenant management".

jeremylongshore/tons-of-skills-marketplace

Collect AppFolio API debug evidence for support tickets. Trigger: "appfolio debug".

jeremylongshore/tons-of-skills-marketplace

Deploy AppFolio integration service to cloud infrastructure. Trigger: "deploy appfolio".

jeremylongshore/tons-of-skills-marketplace

Query AppFolio properties, units, and tenants via REST API. Trigger: "appfolio hello world".

jeremylongshore/tons-of-skills-marketplace

Set up local development for AppFolio property management API integration. Trigger: "appfolio local dev".

jeremylongshore/tons-of-skills-marketplace

Production readiness checklist for AppFolio integrations. Trigger: "appfolio production checklist".

jeremylongshore/tons-of-skills-marketplace

Handle AppFolio API rate limits with throttling and backoff. Trigger: "appfolio rate limit".

jeremylongshore/tons-of-skills-marketplace

Reference architecture for AppFolio property management integration. Trigger: "appfolio architecture".

jeremylongshore/tons-of-skills-marketplace

Apply production-ready patterns for AppFolio REST API integration. Trigger: "appfolio patterns".

関連スキル