Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Configura la autenticación de la API de AppFolio Stack con OAuth 2.0. Úsalo al configurar el acceso a la API de administración de propiedades, registrarte como socio de AppFolio Stack o configurar credenciales de cliente para llamadas API. Dispara con: "install appfolio", "setup appfolio", "appfolio auth", "appfolio API key".

¿Qué es tons-of-skills-marketplace?

Esta habilidad configura la autenticación para la API de AppFolio Stack, permitiendo que agentes de IA (como Claude Code, Cursor o Codex) accedan de forma segura a datos de administración de propiedades. Utiliza HTTP Basic Auth con un ID de cliente y secreto proporcionados por el programa de socios de AppFolio Stack. La habilidad guía al agente a través de la obtención de credenciales, la creación de un cliente REST en TypeScript con axios, y la verificación de la conexión usando un enfoque seguro que evita exponer credenciales en los argumentos de la línea de comandos. Es útil para desarrolladores que integran aplicaciones con AppFolio para gestionar propiedades, unidades, inquilinos, arrendamientos, facturas, proveedores, propietarios e informes. La habilidad incluye manejo de errores para códigos de estado HTTP comunes y enlaces a la documentación oficial de la API y al programa de socios.

Compatible con✓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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Instalación y Autenticación de AppFolio

Descripción general

Configura la autenticación de la API de AppFolio Stack. AppFolio utiliza HTTP Basic Auth con un ID de cliente y un secreto de cliente, proporcionados a través de su programa de socios Stack. No existe un SDK público de npm; se deben usar llamadas REST directas.

Prerrequisitos

  • Cuenta de socio de AppFolio Stack (appfolio.com/stack)
  • ID de cliente y secreto de cliente de AppFolio
  • Node.js 18+ o Python 3.10+

Instrucciones

Paso 1: Obtener credenciales de API

# Las credenciales de la API de AppFolio Stack provienen del programa de socios
# 1. Solicita en appfolio.com/stack/become-a-partner
# 2. Completa la revisión de integración
# 3. Recibe la URL base emitida por el proveedor y las instrucciones de entrega de credenciales.
# Almacena los valores en el gestor de secretos aprobado. Realiza commit solo de esta plantilla
# no secreta si el desarrollo local requiere una:
cat > .env.example << 'ENVFILE'
APPFOLIO_CLIENT_ID=
APPFOLIO_CLIENT_SECRET=
APPFOLIO_BASE_URL=
ENVFILE

# .env permanece ignorado; complétalo solo a través de un flujo de secretos local aprobado.

Paso 2: Crear cliente de 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(`Conectado. Se encontraron ${response.data.length} propiedades`);
      return true;
    } catch (error: any) {
      console.error(`Conexión fallida: ${error.response?.status} ${error.message}`);
      return false;
    }
  }

  get http(): AxiosInstance { return this.api; }
}

export { AppFolioClient };

Paso 3: Verificar conexión

# Diagnóstico rápido y redactado sin poner Basic Auth en argv.
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"

Endpoints de API

RecursoEndpointMétodos
Propiedades/api/v1/propertiesGET
Unidades/api/v1/unitsGET
Inquilinos/api/v1/tenantsGET
Arrendamientos/api/v1/leasesGET, POST
Facturas/api/v1/billsGET, POST
Proveedores/api/v1/vendorsGET
Propietarios/api/v1/ownersGET
Informes/api/v1/reportsGET

Salida

  • Credenciales emitidas por el proveedor inyectadas a través del límite de secretos aprobado
  • Cliente REST en TypeScript con Basic Auth
  • Resultado de conectividad redactado para el endpoint de lectura segura aprobado

Ejemplos

Para un primer ensayo de autenticación, inyecta una credencial de prueba y la URL base emitida por el proveedor a través del mecanismo de secretos local, luego realiza una solicitud de solo lectura a una página de propiedad sintética aprobada. Registra solo el código de estado y el veredicto de configuración del cliente; no imprimas el payload de propiedades, el ID de cliente, el secreto ni la ruta completa del host en registros compartidos. Si el contrato, la URL base, el enlace secreto o el resultado de estado no están verificados, detente antes de cualquier flujo de escritura y haz que el propietario de las credenciales corrija la configuración.

Manejo de errores

ErrorCausaSolución
401 No autorizadoCredenciales inválidasVerifica el ID de cliente/secreto de AppFolio
403 ProhibidoNo es socio de StackCompleta la solicitud de socio
404 No encontradoURL base incorrectaUsa el formato tu-empresa.appfolio.com
Tiempo de esperaProblema de redVerifica que el firewall permita HTTPS a appfolio.com

Recursos

Próximos pasos

Procede a appfolio-hello-world para tu primera consulta de propiedades.

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

Skills relacionados