Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Erstelle ein Property-Management-Dashboard mit Daten der AppFolio-API.

Was ist tons-of-skills-marketplace?

Diese Fähigkeit (Skill) integriert die AppFolio Stack API in KI-Agenten und ermöglicht die vollständige Immobilienverwaltung: Erstellen und Aktualisieren von Immobilieneinträgen, Verwalten von Mieterprofilen und Mietverträgen sowie Abfragen von Belegungsdaten. Sie verwendet OAuth 2.0 Client Credentials für den Server-zu-Server-Zugriff und unterstützt Paginierung über Cursor-Parameter. Die Fähigkeit ist für Claude Code, Cursor und Codex optimiert. Sie stellt strenge Anforderungen an Sandboxen und Idempotenz-Keys, um reale rechtliche und finanzielle Konsequenzen zu vermeiden. Entwickler erhalten klare Anweisungen zur Authentifizierung, zum Erstellen/Updaten von Objekten und zur Abfrage des Belegungsstatus. Die Fehlerbehandlung deckt häufige HTTP-Statuscodes ab.

Funktioniert mit✓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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

AppFolio — Immobilien- & Mieterverwaltung

Überblick

Primärer Workflow für die AppFolio-Immobilienverwaltungsintegration. Deckt den gesamten Lebenszyklus einer Immobilie ab: Erstellen und Aktualisieren von Immobilieneinträgen, Verwalten von Mieterprofilen und Mietverträgen sowie Abfragen von Belegungsdaten. Verwendet die AppFolio Stack API mit OAuth 2.0 Client Credentials für den Server-zu-Server-Zugriff. Alle Endpunkte geben JSON zurück und unterstützen Paginierung über cursor-Parameter für große Portfolios.

Voraussetzungen

  • Ein aktueller AppFolio-Partner-/API-Vertrag, der die bestätigte Portfolio- Basis-URL, Authentifizierungsmethode, freigegebene Bereiche und Schreibfähigkeiten angibt; leiten Sie diese nicht aus einem Tutorial oder einem anderen Portfolio ab.
  • Eine separate Sandbox mit austauschbaren Immobilien, Einheiten und synthetischen Mieterdatensätzen sowie einem Berechtigungsinhaber und einem genehmigten Anforderungsbudget.
  • Idempotenz-Keys und ein vom Betreiber genehmigter Rollback-/Abgleichprozess für Immobilien-, Mieter- und Mietvertragsschreibvorgänge, die reale rechtliche und abrechnungstechnische Konsequenzen haben können.

Anweisungen

  1. Bestätigen Sie die vom Anbieter ausgestellte Basis-URL und den Authentifizierungsablauf für das Ziel- Portfolio, bevor Sie eine Client-Konfiguration in eine Umgebung kopieren.
  2. Führen Sie den Erstellungs-/Aktualisierungspfad nur mit synthetischen Sandbox-Fixtures und Idempotenz-Keys aus; rufen Sie kanonische Datensätze ab, bevor Sie einen unsicheren Schreibvorgang wiederholen.
  3. Validieren Sie Eigentumsverhältnisse, Mietvertragsdaten und Einheitenverfügbarkeit, bevor Sie einen Mietvertrag erstellen, und geben Sie nur Datensatz-IDs und einen gekürzten Statusnachweis aus.
  4. Stufen Sie einen schreibfähigen Ablauf erst hoch, nachdem eine gestaffelte Probe den Rollback, den Abgleich und die niedrigstmöglichen Berechtigungsgrenzen nachweist.

Schritt 1: Authentifizieren und Client initialisieren

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' };

Schritt 2: Eine Immobilie erstellen oder aktualisieren

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(`Immobilie erstellt: ${property.id}`);

Schritt 3: Mieter und Mietvertrag hinzufügen

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());

Schritt 4: Belegung abfragen

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

Fehlerbehandlung

ProblemUrsacheBehebung
401 UnauthorizedAbgelaufenes oder ungültiges TokenErneut mit Client Credentials authentifizieren
404 Not FoundFalsche Immobilien-/Mieter-IDÜberprüfen, ob die Ressourcen-ID existiert, bevor Sie darauf verweisen
422 UnprocessableFehlende Pflichtfeldererrors[]-Array im Antworttext prüfen
409 ConflictDoppelter Mietvertrag für EinheitVor Erstellung vorhandene Mietverträge abfragen
429 Too Many RequestsRatenlimit überschrittenMit dem Wert des Retry-After-Headers zurückhalten

Ausgabe

Ein erfolgreicher Durchlauf erstellt eine Immobilie mit Einheiten, fügt einen Mieter hinzu, bindet sie über einen Mietvertrag und meldet Leerstandszahlen. Die Konsolenausgabe bestätigt jede Ressourcen-ID bei der Erstellung.

Beispiele

Führen Sie für eine Mietvertragserstellungsänderung den Vorgang gegen eine benannte synthetische Sandbox-Einheit und Mieter mit einem stabilen Idempotenz-Key aus. Lesen Sie die Immobilie und die aktuellen Mietverträge, führen Sie den Kandidatenschreibvorgang einmal aus, lesen Sie dann den resultierenden Mietvertrag zurück und erfassen Sie nur IDs, Daten und den Abgleichsstatus. Führen Sie dieselbe Anforderung erneut aus, um nachzuweisen, dass kein zweiter Mietvertrag erstellt wird. Wenn der Anbietervertrag, der Endpunkt, die Autorisierung oder das Ergebnis des vorherigen Schreibvorgangs nicht überprüft werden können, stoppen Sie vor jedem Schreibvorgang und leiten Sie den Fall zur Abstimmung an den Portfolio-Betreiber weiter.

Ressourcen

Nächste Schritte

Fahren Sie mit appfolio-core-workflow-b für Wartungsanfragen und Zahlungsverfolgung fort.

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

Verwandte Skills