Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

AppFolio APIデータを使用して物件管理ダッシュボードを構築します。

tons-of-skills-marketplace とは?

このスキルは、AppFolio Stack API(OAuth 2.0 クライアント認証情報を利用したサーバー間アクセス)と連携して、物件管理ライフサイクル全体を自動化します。物件レコードの作成・更新、テナントプロフィールと賃貸契約の管理、空室状況のクエリをサポートします。すべてのAPIエンドポイントはJSONを返し、大規模ポートフォリオ向けに`cursor`パラメータによるページネーションに対応しています。本番環境で書き込みを実行する前に、適切なAPI契約、サンドボックス環境、冪等性キー、およびロールバック/調整プロセスが必須です。このスキルは、Claude Code、Cursor、Codexなどの主要なAIエージェントプラットフォームで動作するよう設計されています。マークダウン形式のSKILL.mdには、認証、物件作成、テナント・賃貸契約管理、空室クエリの実装手順に加え、エラーハンドリングテーブルや安全な使用のためのベストプラクティスが含まれています。

対応✓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-core-workflow-a

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

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

ドキュメント

AppFolio — 物件&テナント管理

概要

AppFolio 物件管理統合の主要ワークフローです。物件レコードの作成・更新、テナントプロフィールと賃貸契約の管理、占有データのクエリといった物件ライフサイクル全体をカバーします。OAuth 2.0 クライアント認証情報を使用したサーバー間アクセスで AppFolio Stack API を利用します。すべてのエンドポイントは JSON を返し、大規模ポートフォリオ向けに cursor パラメータによるページネーションをサポートします。

前提条件

  • 割り当てられたポートフォリオのベースURL、認証方法、承認済みスコープ、書き込み機能を確認する、有効な AppFolio パートナー/API 契約。チュートリアルや他のポートフォリオからこれらを推測しないでください。
  • 使い捨て可能な物件、ユニット、および合成テナントレコード、さらに認証情報所有者と承認済みリクエスト予算を備えた、別のサンドボックス。
  • 物件、テナント、賃貸契約の書き込みに関する冪等性キーとオペレーター承認済みのロールバック/調整プロセス。実際の法的および請求上の影響が生じる可能性があります。

手順

  1. クライアント設定を環境にコピーする前に、対象ポートフォリオに対してプロバイダー発行のベースURLと認証フローを確認します。
  2. 作成/更新パスは、サンドボックスの合成フィクスチャと冪等性キーでのみ実行し、不確かな書き込みを再試行する前に正規レコードを取得します。
  3. 賃貸契約を作成する前に、所有権、賃貸契約期間、ユニットの空室状況を検証し、レコードIDと編集済みステータス証拠のみを出力します。
  4. 書き込み可能なフローは、ロールバック、調整、および最小権限スコープ境界を証明する段階的なリハーサルの後にのみ本番投入します。

ステップ 1: 認証とクライアントの初期化

const token = await fetch('https://api.appfolio.com/oauth/token', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    grant_type: 'client_credentials',
    client_id: process.env.APPFOLIO_CLIENT_ID!,
    client_secret: process.env.APPFOLIO_CLIENT_SECRET!,
    scope: 'properties tenants leases',
  }),
}).then(r => r.json());
const headers = { Authorization: `Bearer ${token.access_token}`, 'Content-Type': 'application/json' };

ステップ 2: 物件の作成または更新

const property = await fetch('https://api.appfolio.com/v1/properties', {
  method: 'POST', headers,
  body: JSON.stringify({
    name: 'Sunrise Apartments',
    address: { street: '100 Main St', city: 'Austin', state: 'TX', zip: '78701' },
    type: 'residential',
    units: [
      { number: '101', bedrooms: 2, bathrooms: 1, rent: 1450 },
      { number: '102', bedrooms: 1, bathrooms: 1, rent: 1100 },
    ],
  }),
}).then(r => r.json());
console.log(`Property created: ${property.id}`);

ステップ 3: テナントと賃貸契約の追加

const tenant = await fetch('https://api.appfolio.com/v1/tenants', {
  method: 'POST', headers,
  body: JSON.stringify({
    first_name: 'Test', last_name: 'Tenant',
    email: '[email protected]', phone: '555-0100',
  }),
}).then(r => r.json());

await fetch('https://api.appfolio.com/v1/leases', {
  method: 'POST', headers,
  body: JSON.stringify({
    property_id: property.id, unit_number: '101',
    tenant_id: tenant.id, start_date: '2026-05-01', end_date: '2027-04-30',
    monthly_rent: 1450, security_deposit: 1450,
  }),
}).then(r => r.json());

ステップ 4: 空室状況のクエリ

const units = await fetch(
  `https://api.appfolio.com/v1/properties/${property.id}/units?status=vacant`,
  { headers },
).then(r => r.json());
console.log(`Vacant units: ${units.data.length} of ${units.meta.total}`);

エラーハンドリング

問題原因修正方法
401 Unauthorizedトークンの期限切れまたは無効クライアント認証情報で再認証
404 Not Found誤った物件/テナントID参照前にリソースIDの存在を確認
422 Unprocessable必須フィールドの欠落レスポンス本文の errors[] 配列を確認
409 Conflictユニットに対する重複賃貸契約作成前に既存の賃貸契約をクエリ
429 Too Many Requestsレート制限超過Retry-After ヘッダー値に従ってバックオフ

出力

正常に実行されると、ユニットを持つ物件が作成され、テナントが追加され、賃貸契約でバインドされ、空室数が報告されます。コンソール出力により、作成時の各リソースIDが確認できます。

例

賃貸契約作成の変更の場合、名前付きの合成サンドボックスユニットとテナントに対して、安定した冪等性キーを使用して実行します。物件と現在の賃貸契約を読み取り、候補となる書き込みを1回実行し、結果の賃貸契約を読み戻して、ID、日付、および調整ステータスのみを記録します。同じリクエストを再実行して、2番目の賃貸契約が作成されないことを確認します。プロバイダー契約、エンドポイント、認証、または事前の書き込み結果が検証できない場合は、書き込み前に停止し、調整のためにポートフォリオオペレーターにケースを送信します。

リソース

次のステップ

保守リクエストと支払い追跡については、appfolio-core-workflow-b に進んでください。

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

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

Configure AppFolio Stack API authentication with OAuth 2.0. Use when setting up property management API access, registering as an AppFolio Stack partner, or configuring client credentials for API calls. Trigger: "install appfolio", "setup appfolio", "appfolio auth", "appfolio API key".

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".

関連スキル