Agent Skills: API Researcher

Expert API research including discovery, evaluation, integration analysis, and documentation review

UncategorizedID: ljchg12-hue/windows-dotfiles/api-researcher

Install this agent skill to your local

pnpm dlx add-skill https://github.com/ljchg12-hue/windows-dotfiles/tree/HEAD/.claude/skills/research/api-researcher

Skill Files

Browse the full folder contents for api-researcher.

Download Skill

Loading file tree…

.claude/skills/research/api-researcher/SKILL.md

Skill Metadata

Name
api-researcher
Description
Expert API research including discovery, evaluation, integration analysis, and documentation review

API Researcher

Purpose

Research, evaluate, and document APIs including feature analysis, integration complexity, and usage recommendations.

Activation Keywords

  • api research, find api
  • api evaluation, api comparison
  • integration complexity, api docs
  • rest api, graphql api
  • api features, api pricing

Core Capabilities

1. API Discovery

  • Public API catalogs
  • Category search
  • Feature matching
  • Alternative finding
  • Emerging APIs

2. Documentation Analysis

  • Completeness assessment
  • Example quality
  • SDK availability
  • Error documentation
  • Rate limit clarity

3. Integration Evaluation

  • Authentication methods
  • Request/response format
  • Rate limits
  • Error handling
  • Versioning strategy

4. Quality Assessment

  • Reliability (uptime)
  • Performance (latency)
  • Support quality
  • Community size
  • Update frequency

5. Comparison

  • Feature matrices
  • Pricing comparison
  • Limit comparison
  • DX comparison
  • Migration complexity

API Evaluation Template

## API Research: [API Name]

### Overview
- **Provider**: [Company]
- **Type**: [REST/GraphQL/gRPC]
- **Version**: [Current version]
- **Status**: [GA/Beta/Deprecated]

### Authentication
- **Methods**: [API Key/OAuth/JWT]
- **Complexity**: [Simple/Moderate/Complex]
- **Setup Time**: [Estimate]

### Endpoints Summary
| Category | Endpoints | Notes |
|----------|-----------|-------|
| [Category 1] | N | [Notes] |
| [Category 2] | N | [Notes] |

### Rate Limits
| Tier | Requests | Period |
|------|----------|--------|
| Free | X | per minute |
| Pro | Y | per minute |

### Pricing
| Tier | Price | Includes |
|------|-------|----------|
| Free | $0 | X calls/month |
| Pro | $X/mo | Y calls/month |
| Enterprise | Custom | Unlimited |

### SDK Availability
- JavaScript/Node: ✅/❌
- Python: ✅/❌
- Go: ✅/❌
- Ruby: ✅/❌

### Documentation Quality
| Aspect | Score | Notes |
|--------|-------|-------|
| Completeness | X/10 | [Assessment] |
| Examples | X/10 | [Assessment] |
| Error docs | X/10 | [Assessment] |
| Search | X/10 | [Assessment] |

### Integration Complexity
- **Overall**: [Easy/Moderate/Complex]
- **Time Estimate**: [X hours/days]
- **Gotchas**: [List any known issues]

### Recommendation
[Use/Consider/Avoid] for [use case]

API Discovery Sources

| Source | URL | Best For | |--------|-----|----------| | RapidAPI | rapidapi.com | General discovery | | Public APIs | public-apis.io | Free APIs | | ProgrammableWeb | programmableweb.com | Directory | | API List | apilist.fun | Curated list | | Postman | postman.com/explore | Collections |

Example Usage

User: "Research payment APIs for a SaaS application"

API Researcher Response:

## API Research: Payment APIs for SaaS

### Candidates Evaluated
1. Stripe
2. Paddle
3. LemonSqueezy

### Quick Comparison
| Feature | Stripe | Paddle | LemonSqueezy |
|---------|--------|--------|------------|
| MoR | No | Yes | Yes |
| Subscriptions | ✅ | ✅ | ✅ |
| Tax handling | Add-on | Included | Included |
| Fees | 2.9%+30¢ | 5%+50¢ | 5%+50¢ |
| Setup complexity | Medium | Low | Low |

### Detailed: Stripe
- **Auth**: API Keys + Webhooks
- **SDK**: Excellent (all languages)
- **Docs**: 10/10
- **Integration time**: 1-2 days
- **Best for**: Full control, international

### Detailed: Paddle
- **Auth**: API Keys + Webhooks
- **SDK**: Good (JS, Python)
- **Docs**: 8/10
- **Integration time**: 4-8 hours
- **Best for**: SaaS, MoR needed

### Detailed: LemonSqueezy
- **Auth**: API Keys + Webhooks
- **SDK**: Basic (JS)
- **Docs**: 7/10
- **Integration time**: 2-4 hours
- **Best for**: Simple SaaS, indie

### Recommendation
- **Enterprise SaaS**: Stripe (flexibility)
- **Solo/Indie**: LemonSqueezy (simplicity)
- **Tax concerns**: Paddle (MoR included)