Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

REST API を使用して AppFolio の物件、ユニット、テナントをクエリします。トリガー: "appfolio hello world"。

tons-of-skills-marketplace とは?

このスキルは、AppFolio Property Manager API への最初の安全な読み取りアクセスを提供し、検証済みのプロバイダー発行クライアント設定を使用して、物件リストとテナント数を取得します。このスキルの主な目的は、管理されたクライアント設定と承認された読み取り専用エンドポイントが期待どおりに動作することを確認することです。書き込み操作(作業指示などの作成)は、このスキルでは禁止されており、別途承認された合成サンドボックスワークフローに委ねられます。Node.js 18+ と TypeScript をサポートし、AppFolio Stack パートナーアカウントが必要です。エラーハンドリングには、401 Unauthorized や 429 Rate Limited などの一般的な HTTP エラーが含まれ、環境変数による認証情報管理やレート制限へのバックオフ戦略が推奨されています。このスキルは、AppFolio 統合を開発する開発者が、本番操作に進む前に安全に接続性を検証するための、ゲートキーパーとして機能します。

対応✓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-hello-world

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

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

ドキュメント

AppFolio Hello World

概要

検証済みのプロバイダー発行クライアント設定を使用して、AppFolio Property Manager API を使い始めましょう。このスキルでは、物件リストとテナント数を安全に最初に読み取る手順を説明します。作成や更新の操作は、別途承認された合成サンドボックスワークフローにのみ属します。

前提条件

  • API アクセス権を持つ AppFolio Stack パートナーアカウント
  • 対象ポートフォリオに対して確認済みの、プロバイダー発行のベース URL と認証クライアントを管理していること。推測したホスト名や認証スキームは使用しないでください。
  • Node.js 18+ および TypeScript

手順

ステップ 1: クライアントを設定する

async function appfolioFetch(path: string) {
  const res = await createVerifiedAppFolioClient().get(path);
  if (res.status < 200 || res.status >= 300) throw new Error(`AppFolio ${res.status}`);
  return res.data;
}

ステップ 2: 物件を一覧表示する

const properties = await appfolioFetch("/properties?page_size=10");
console.log(`Found ${properties.length} properties`);
properties.forEach((p: any) => console.log(`  property ID: ${p.id}`));

ステップ 3: テナントの詳細を取得する

const tenants = await appfolioFetch(`/tenants?property_id=${properties[0].id}`);
console.log(`Retrieved ${tenants.length} tenant records for the approved fixture`);

ステップ 4: 書き込みの前に停止する

// クイックスタートテストとして作業指示を作成しないでください。appfolio-core-workflow-b の合成された冪等なワークフローでのみ続行してください。

出力

正常な実行は、管理されたクライアントと承認された安全な読み取りエンドポイントが機能することを証明し、ローカル出力に物件 ID とテナントレコード数のみを返します。

例

初回統合チェックとして、検証済みのサンドボックスクライアントを設定し、承認された合成物件ページを 1 つクエリし、住所、名前、ユニット番号、認証情報を記録せずに、そのステータス、物件 ID、テナント数を確認します。単にアクセスをテストするために作業指示を作成しないでください。ポートフォリオ契約、安全な読み取りフィクスチャ、または応答認証が検証されていない場合は、実行を停止し、すべての変更を行う前に、認証情報所有者のステージングプロセスを使用してください。

エラーハンドリング

エラー原因解決策
401 Unauthorizedclient_id または secret が無効環境変数で認証情報を確認する
403 ForbiddenAPI スコープが付与されていないエンドポイントの Stack Partner 権限を確認する
404 Not Foundベース URL またはエンドポイントが間違っている会社のサブドメインと API バージョンを確認する
422 Unprocessable必須フィールドが不足しているproperty_id と必須の本文パラメータを検証する
429 Too Many Requestsレート制限を超えたバックオフ遅延を追加し、リクエストをバッチ処理する

リソース

次のステップ

完全な物件およびテナント管理ワークフローについては、appfolio-core-workflow-a を参照してください。

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

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

関連スキル