@nordsym/apiclaw 1.4.1 → 1.4.3

package/AGENTS.md

@@ -155,11 +155,126 @@ Contact: gustav@nordsym.com
 
 ---
 
+## Integration with Agent Frameworks
+
+APIClaw works standalone via MCP, but also integrates with popular agent frameworks.
+
+### Tool Counts
+
+| Category | Count | Description |
+|----------|-------|-------------|
+| **Direct Call** | 18 | Full proxy, no keys needed |
+| **Open APIs** | 1,636 | Public APIs, may need keys |
+| **Discovery** | 22,392 | Searchable API database |
+
+### CrewAI
+
+```python
+from crewai import Agent, Tool
+from apiclaw import APIClaw
+
+claw = APIClaw()
+
+# Create tools from APIClaw
+discover_tool = Tool(
+    name="discover_apis",
+    func=claw.discover,
+    description="Search 22,000+ APIs by capability"
+)
+
+call_tool = Tool(
+    name="call_api",
+    func=claw.call,
+    description="Execute API calls through APIClaw proxy"
+)
+
+# Use in your agent
+researcher = Agent(
+    role="API Researcher",
+    tools=[discover_tool, call_tool],
+    # ...
+)
+```
+
+### AutoGPT
+
+Add to your AutoGPT plugins:
+
+```python
+# plugins/apiclaw_plugin.py
+from apiclaw import APIClaw
+
+class APIClawPlugin:
+    def __init__(self):
+        self.claw = APIClaw()
+    
+    def discover_apis(self, query: str) -> list:
+        """Search APIs by capability."""
+        return self.claw.discover(query)
+    
+    def call_api(self, provider: str, action: str, params: dict) -> dict:
+        """Execute API call through proxy."""
+        return self.claw.call(provider, action, params)
+```
+
+Register in `plugins/__init__.py` and you're set.
+
+### LangChain
+
+```python
+from langchain.tools import StructuredTool
+from apiclaw import APIClaw
+
+claw = APIClaw()
+
+discover_tool = StructuredTool.from_function(
+    func=claw.discover,
+    name="discover_apis",
+    description="Search 22,000+ APIs by what they do, not keywords"
+)
+
+call_tool = StructuredTool.from_function(
+    func=claw.call,
+    name="call_api", 
+    description="Execute API calls. 18 providers work without keys."
+)
+
+# Add to your agent
+tools = [discover_tool, call_tool]
+```
+
+### Environment Setup
+
+For all frameworks:
+
+```bash
+pip install apiclaw
+```
+
+Or use the MCP server directly if your framework supports it:
+
+```bash
+npx @nordsym/apiclaw
+```
+
+### Why This Matters
+
+Agent frameworks give you orchestration. APIClaw gives you execution.
+
+- **CrewAI** agents can now call real APIs, not just reason about them
+- **AutoGPT** loops can send SMS, generate images, search the web
+- **LangChain** chains can hit 18 providers without key management
+
+The 22,392 APIs in discovery are searchable by capability. Ask for "GDPR-compliant email with analytics" and get ranked results. The 18 Direct Call providers execute instantly through our proxy.
+
+---
+
 ## Links
 
 - **Docs:** https://apiclaw.nordsym.com/docs
 - **GitHub:** https://github.com/nordsym/apiclaw
 - **npm:** https://npmjs.com/package/@nordsym/apiclaw
+- **PyPI:** https://pypi.org/project/apiclaw
 - **Status:** https://apiclaw.nordsym.com (live stats on homepage)
 
 ---

package/CHANGELOG.md

@@ -0,0 +1,78 @@
+# Changelog
+
+All notable changes to APIClaw.
+
+## [Unreleased]
+
+---
+
+## [0.4.0] - 2026-03
+
+### Added
+- **Dry-run mode** — Test API calls without execution. Validate params, check auth, see what would happen.
+- **Auto retry** — Transient failures (429, 503, timeouts) automatically retry with exponential backoff.
+- **Error codes** — Standardized error responses across all providers. `RATE_LIMITED`, `AUTH_FAILED`, `INVALID_PARAMS`, etc.
+
+### Improved
+- Better error messages with actionable suggestions
+- Retry logic respects provider-specific rate limit headers
+
+---
+
+## [0.3.0] - 2026-03
+
+### Added
+- **Multi-client support** — Works with Claude Desktop, Cursor, Windsurf, Cline, and Continue
+- **Usage logs** — Track API calls, costs, and success rates in your dashboard
+- **18 Direct Call providers** — Full proxy support for:
+  - Replicate, OpenRouter, ElevenLabs, 46elks, Twilio
+  - Resend, Brave Search, Firecrawl, E2B, GitHub
+  - Groq, Deepgram, Serper, Mistral, Cohere
+  - Together AI, Stability AI, AssemblyAI
+
+### Improved
+- `mcp-install` now auto-detects client and configures accordingly
+- Dashboard shows real-time usage across all clients
+
+---
+
+## [0.2.0] - 2026-02
+
+### Added
+- **Workspace & Dashboard** — Manage your API usage, view logs, configure settings
+- **Auth with Magic Link** — No passwords. Email link, you're in.
+- **`mcp-install` command** — One command setup: `npx @nordsym/apiclaw mcp-install`
+
+### Improved
+- Simplified onboarding flow
+- Better MCP server configuration
+
+---
+
+## [0.1.0] - 2026-02
+
+### Added
+- Initial release
+- MCP server for API discovery and execution
+- `discover_apis` — Search 22,000+ APIs by capability
+- `get_api_details` — Full API specifications
+- `call_api` — Direct execution through proxy
+- `list_connected` — See available Direct Call providers
+
+---
+
+## Versioning
+
+We use [SemVer](https://semver.org/). Given version `MAJOR.MINOR.PATCH`:
+
+- **MAJOR** — Breaking changes to MCP interface
+- **MINOR** — New features, new providers, backward compatible
+- **PATCH** — Bug fixes, performance improvements
+
+---
+
+## Links
+
+- [Documentation](https://apiclaw.nordsym.com/docs)
+- [GitHub](https://github.com/nordsym/apiclaw)
+- [npm](https://npmjs.com/package/@nordsym/apiclaw)

package/CONTRIBUTING.md

@@ -0,0 +1,84 @@
+# Contributing to APIClaw
+
+Thanks for wanting to contribute! We keep this simple.
+
+## Quick Start
+
+```bash
+# Clone
+git clone https://github.com/nordsym/apiclaw.git
+cd apiclaw
+
+# Install
+npm install
+
+# Run locally
+npm run dev
+```
+
+## Ways to Contribute
+
+### 🐛 Found a Bug?
+
+1. Check [existing issues](https://github.com/nordsym/apiclaw/issues) first
+2. Open a new issue with:
+   - What happened
+   - What you expected
+   - Steps to reproduce
+   - Your environment (OS, Node version, MCP client)
+
+### 💡 Have an Idea?
+
+Open an issue! We love feature requests. Even if we can't build it immediately, it helps us understand what people need.
+
+### 🔧 Want to Code?
+
+1. Fork the repo
+2. Create a branch (`git checkout -b fix/thing` or `feat/thing`)
+3. Make your changes
+4. Test locally
+5. Open a PR
+
+We'll review quickly. If it's good, it ships.
+
+### 📝 Docs Need Fixing?
+
+PRs for typos, clarifications, and better examples are always welcome. Don't overthink it — just fix and PR.
+
+## Code Style
+
+- We use Prettier (it runs on commit)
+- TypeScript strict mode
+- Keep it simple — readable > clever
+
+## Testing
+
+```bash
+npm test
+```
+
+Add tests for new features. Fix tests you break.
+
+## Commit Messages
+
+Keep them clear:
+
+```
+fix: handle rate limit headers correctly
+feat: add Anthropic to Direct Call providers
+docs: clarify mcp-install for Cursor users
+```
+
+## Questions?
+
+- Open an issue
+- Email: gustav@nordsym.com
+- Telegram: @HokusPontuz
+
+## License
+
+MIT. Your contributions will be too.
+
+---
+
+🦞