# GST Cranes SDK and CLI

The `@gstcranes/gstcranes` npm package is the public SDK and CLI for GST Cranes developer resources.

Install:

```bash
npm install @gstcranes/gstcranes
npm install -g @gstcranes/cli
npm install -g @gstcranes/gstcranes
npm install https://gstcranes.com/sdk/gstcranes-gstcranes-0.1.0.tgz
npm install -g @gstcranes/mcp-server
gstcranes --help
npx --yes @gstcranes/mcp-server
npx skills add gkmex75/gstcranes-agent-rules
npx --yes --package @gstcranes/cli gstcranes openapi
npx --yes --package @gstcranes/gstcranes gstcranes list-companies --country DE --limit 5
npx --yes --package @gstcranes/gstcranes gstcranes ask "companies with Liebherr LTM 1750 records"
```

SDK example:

```ts
import { GstCranesClient } from '@gstcranes/gstcranes';

const client = new GstCranesClient();
const companies = await client.listCompanies({ country: 'DE', limit: 10 });
const answer = await client.ask('companies with Liebherr LTM 1750 records');
```

CLI commands:

- `gstcranes openapi`
- `gstcranes list-companies --country DE --limit 10`
- `gstcranes get-company bms-heavy-cranes`
- `gstcranes batch-companies bms-heavy-cranes gkmex`
- `gstcranes ask "where are GST Cranes developer resources?"`
- `gstcranes handoff marketplace --query "Liebherr LTM 1300"`
- `gstcranes handoff sell`
- `gstcranes handoff wanted`

Scope:

- Public company and Crane Wiki reads through `/api/companies`.
- Public resource routing through `/ask`.
- Browser handoff URLs for marketplace, wanted ads, sell flow, company pages, and developer resources.
- No payment, credit spend, listing publication, wanted-ad publication, saved alert, account, or admin mutation runs through this package.

Canonical resources:

- NPM package: https://www.npmjs.com/package/@gstcranes/gstcranes
- CLI npm package: https://www.npmjs.com/package/@gstcranes/cli
- npm tarball fallback: https://gstcranes.com/sdk/gstcranes-gstcranes-0.1.0.tgz
- Source package: https://gstcranes.com/sdk-source
- CLI manifest: https://gstcranes.com/.well-known/cli.json
- CLI command guide: https://gstcranes.com/cli.md
- Developer page: https://gstcranes.com/developers
- OpenAPI: https://gstcranes.com/.well-known/openapi.json
- API catalog: https://gstcranes.com/.well-known/api-catalog
- MCP endpoint: https://gstcranes.com/.well-known/mcp
- MCP npm package: https://www.npmjs.com/package/@gstcranes/mcp-server
- Agent rules repository: https://github.com/gkmex75/gstcranes-agent-rules