api-integrator

Integrate external REST and GraphQL APIs with authentication, retries, and schema validation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dredd-us/seashells --skill api-integrator-dredd-us
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-integrator
Source: https://github.com/dredd-us/seashells/tree/main/.claude/skills/api-integrator
Command: npx skills add https://github.com/dredd-us/seashells --skill api-integrator-dredd-us

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, tenacity, pydantic, requests-oauthlib, psycopg2.

What problem does it solve?

This Skill provides robust, cost-effective patterns for integrating external APIs and databases, eliminating the need for expensive LLM calls for every interaction and ensuring reliable data exchange.

Core Features & Use Cases

  • Robust API Calls: Handles REST/GraphQL APIs with authentication (Bearer, Basic, OAuth), error handling, and retry logic.
  • Cost-Efficient: Achieves 10-30x cost savings by executing API calls directly rather than through LLM-based calls.
  • Use Case: Integrate with a payment gateway like Stripe, a communication service like Twilio, or AWS services, ensuring secure, validated, and resilient interactions.

Quick Start

Use the api-integrator skill to make a GET request to 'https://api.github.com/users/github' and print the 'created_at' field.

Frequently Asked Questions about api-integrator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate external REST and GraphQL APIs with authentication?

REST and GraphQL API integration is handled through Bearer, Basic, and OAuth authentication methods. This Skill automates the connection with built-in error handling, retry logic, and response validation using Pydantic schemas, eliminating manual credential management and ensuring reliable data exchange.

Can I reduce API costs by calling external services directly instead of through LLMs?

Yes. Direct API calls achieve 10-30x cost savings compared to LLM-based integration. This Skill executes requests to services like Stripe, Twilio, and AWS with exponential backoff retries and timeout handling, bypassing expensive language model overhead while maintaining security and validation.

What authentication methods work with REST API calls?

REST API calls support Bearer tokens, Basic authentication, and OAuth flows. Environment-based credential management ensures secure handling of secrets without hardcoding, and Pydantic validation enforces strict response schemas for validated data exchange.

How do I handle API failures and timeouts reliably?

Retry logic with exponential backoff automatically recovers from transient failures, while configurable timeouts prevent hanging requests. This Skill combines tenacity-based retry strategies with JSON schema validation to ensure only valid responses proceed downstream.

Does this work with database queries alongside API calls?

Yes. The Skill integrates external REST and GraphQL APIs with database queries through psycopg2, enabling workflows that fetch data from APIs, validate it against schemas, and persist results to PostgreSQL in a single, coordinated operation.

What's the difference between using this for API integration versus making raw HTTP requests?

Direct HTTP requests lack built-in retry logic, authentication abstraction, and schema validation. This Skill adds exponential backoff, OAuth support, Pydantic-enforced data validation, and environment credential management—reducing boilerplate and eliminating entire categories of integration bugs.