Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Consultar propriedades, unidades e inquilinos do AppFolio via API REST.

O que é tons-of-skills-marketplace?

Esta skill permite que agentes de IA (como Claude Code, Cursor ou Codex) consultem com segurança a API REST do AppFolio Property Manager, retornando dados de propriedades e inquilinos usando um cliente configurado e verificado pelo provedor. Ela foi projetada para operações de leitura seguras e de baixo risco, evitando explicitamente qualquer operação de criação ou atualização fora de um fluxo de trabalho sintético aprovado. A skill fornece instruções passo a passo para configurar o cliente, listar propriedades e obter detalhes dos inquilinos, tratando erros comuns como 401, 403 e 429. É ideal para integrações iniciais e verificações de configuração, garantindo que o agente use apenas endpoints de leitura aprovados antes de passar para fluxos de trabalho mais complexos.

Funciona com✓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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

AppFolio Hello World

Visão Geral

Comece a usar a API do AppFolio Property Manager através de uma configuração de cliente verificada e emitida pelo provedor. Esta skill aborda leituras seguras iniciais para uma listagem de propriedades e uma contagem de inquilinos; operações de criação ou atualização pertencem apenas a um fluxo de trabalho sintético separadamente aprovado.

Pré-requisitos

  • Conta de parceiro AppFolio Stack com acesso à API
  • Um URL base gerenciado e emitido pelo provedor, e um cliente de autenticação confirmado para o portfólio alvo; não use um hostname ou esquema de credenciais adivinhado
  • Node.js 18+ e TypeScript

Instruções

Passo 1: Configurar o Cliente

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

Passo 2: Listar Propriedades

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

Passo 3: Obter Detalhes dos Inquilinos

const tenants = await appfolioFetch(`/tenants?property_id=${properties[0].id}`);
console.log(`Recuperados ${tenants.length} registros de inquilinos para o fixture aprovado`);

Passo 4: Parar Antes de Escritas

// Não crie uma ordem de serviço como teste de início rápido. Continue apenas com o
// fluxo de trabalho sintético e idempotente em appfolio-core-workflow-b.

Saída

Uma execução bem-sucedida prova que o cliente gerenciado e um endpoint de leitura segura aprovado funcionam, retornando apenas IDs de propriedades e uma contagem de registros de inquilinos em sua saída local.

Exemplos

Para uma primeira verificação de integração, configure o cliente de sandbox verificado, consulte uma página de propriedade sintética aprovada e confirme seu status, IDs de propriedades e contagem de inquilinos sem gravar endereços, nomes, números de unidades ou credenciais. Não crie uma ordem de serviço meramente para testar o acesso. Se o contrato do portfólio, o fixture de leitura segura ou a autorização de resposta não estiverem verificados, pare a execução e use o processo de staging do proprietário da credencial antes de tentar qualquer mutação.

Tratamento de Erros

ErroCausaSolução
401 Unauthorizedclient_id ou secret inválidoVerifique as credenciais nas variáveis de ambiente
403 ForbiddenEscopo da API não concedidoVerifique as permissões do Stack Partner para o endpoint
404 Not FoundURL base ou endpoint erradoConfirme seu subdomínio da empresa e a versão da API
422 UnprocessableCampos obrigatórios ausentesValide property_id e os parâmetros obrigatórios do corpo
429 Too Many RequestsLimite de taxa excedidoAdicione atraso de backoff, faça requisições em lote

Recursos

Próximos Passos

Veja appfolio-core-workflow-a para fluxos de trabalho completos de gerenciamento de propriedades e inquilinos.

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

Habilidades Relacionadas