PHPackages                             shipfastlabs/toolkit-jigsawstack - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. shipfastlabs/toolkit-jigsawstack

ActiveLibrary[Utility & Helpers](/categories/utility)

shipfastlabs/toolkit-jigsawstack
================================

JigsawStack tools for the Laravel AI SDK - sentiment, summary, embedding, translation, web search, scraping, vision, audio, and validation

00PHP

Since Jun 7Pushed 2d agoCompare

[ Source](https://github.com/shipfastlabs/toolkit-jigsawstack)[ Packagist](https://packagist.org/packages/shipfastlabs/toolkit-jigsawstack)[ RSS](/packages/shipfastlabs-toolkit-jigsawstack/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (1)DependenciesVersions (1)Used By (0)

shipfastlabs/toolkit-jigsawstack
================================

[](#shipfastlabstoolkit-jigsawstack)

[![Latest Version](https://camo.githubusercontent.com/3d25db24574042342c6449b8216152db6734cf37b97fdc55043310324634bce0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73686970666173746c6162732f746f6f6c6b69742d6a6967736177737461636b2e737667)](https://packagist.org/packages/shipfastlabs/toolkit-jigsawstack)[![Total Downloads](https://camo.githubusercontent.com/46b20e5e1e2a9c4e3371ea9fa0ea5d7571d55b6cc9e0825798bf211f8f579a6e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73686970666173746c6162732f746f6f6c6b69742d6a6967736177737461636b2e737667)](https://packagist.org/packages/shipfastlabs/toolkit-jigsawstack)

> JigsawStack tools for the Laravel AI SDK - sentiment, summary, embedding, translation, web search, scraping, vision, audio, and validation

Part of the [shipfastlabs/toolkit](https://github.com/shipfastlabs/toolkit) catalog of reusable AI tools for the Laravel AI SDK.

Installation
------------

[](#installation)

```
composer require shipfastlabs/toolkit-jigsawstack
```

Usage
-----

[](#usage)

Register every JigsawStack tool at once with the `JigsawStack` helper:

```
use Shipfastlabs\Toolkit\JigsawStack\JigsawStack;

$tools = JigsawStack::all(); // Collection
```

Or add individual tools to an agent's `tools()`:

```
use Shipfastlabs\Toolkit\JigsawStack\JigsawStackWebSearch;
use Shipfastlabs\Toolkit\JigsawStack\JigsawStackSummary;

$tools = [
    new JigsawStackWebSearch,
    new JigsawStackSummary,
];
```

Tools
-----

[](#tools)

Each tool maps to a JigsawStack endpoint and returns the raw JSON response (pretty-printed) so the model can read every field.

### General

[](#general)

ClassEndpointRequiredOptional`JigsawStackSentiment``POST /v1/ai/sentiment``text`—`JigsawStackSummary``POST /v1/ai/summary``text``type` (`text`|`points`), `max_points``JigsawStackEmbedding``POST /v1/embedding``text``type` (default `text`)`JigsawStackPrediction``POST /v1/ai/prediction``dataset` (JSON array of `{date,value}`)`steps``JigsawStackTextToSql``POST /v1/ai/sql``prompt``sql_schema`, `database`### Translation

[](#translation)

ClassEndpointRequiredOptional`JigsawStackTranslateText``POST /v1/ai/translate``text`, `target_language``current_language``JigsawStackTranslateImage``POST /v1/ai/translate/image``url`, `target_language`—### Web

[](#web)

ClassEndpointRequiredOptional`JigsawStackWebSearch``POST /v1/web/search``query``ai_overview`, `safe_search`, `max_results``JigsawStackAiScrape``POST /v1/ai/scrape``url`, `element_prompts` (comma-separated)`root_element_selector``JigsawStackHtmlToAny``POST /v1/web/html_to_any``html``type` (`png`|`jpeg`|`webp`|`pdf`), `full_page``JigsawStackSearchSuggestions``GET /v1/web/search/suggest``query`—### Vision

[](#vision)

ClassEndpointRequiredOptional`JigsawStackVocr``POST /v1/vocr``url``prompt``JigsawStackObjectDetection``POST /v1/object_detection``url``prompts` (comma-separated), `annotated_image`### Audio

[](#audio)

ClassEndpointRequiredOptional`JigsawStackSpeechToText``POST /v1/ai/transcribe``url``language`, `translate`### Validation

[](#validation)

ClassEndpointRequiredOptional`JigsawStackNsfwDetection``POST /v1/validate/nsfw``url`—`JigsawStackProfanityCheck``POST /v1/validate/profanity``text``censor_replacement``JigsawStackSpellCheck``POST /v1/validate/spell_check``text``language_code``JigsawStackSpamCheck``POST /v1/validate/spam_check``text`—Configuration
-------------

[](#configuration)

Every tool reads its API key from Laravel's `services` config.

### 1. Add the JigsawStack service to `config/services.php`

[](#1-add-the-jigsawstack-service-to-configservicesphp)

```
// config/services.php

return [

    // ... existing services ...

    'jigsawstack' => [
        'key' => env('JIGSAWSTACK_API_KEY'),
    ],

];
```

### 2. Add the environment variable to `.env`

[](#2-add-the-environment-variable-to-env)

```
JIGSAWSTACK_API_KEY=your-key-here
```

Config keyEnv varDefaultDescription`services.jigsawstack.key``JIGSAWSTACK_API_KEY`-**Required.** Your JigsawStack API key, sent as the `x-api-key` header.Safety
------

[](#safety)

- All tools validate required inputs before calling the API.
- Requests time out after 60 seconds.
- API errors and network failures are caught and returned as friendly string messages so the model can recover.
- Requires a valid JigsawStack API key; tools return a clear "not configured" message when it is missing.

JigsawStack API
---------------

[](#jigsawstack-api)

These tools use the [JigsawStack API](https://jigsawstack.com/docs). See the [API reference](https://jigsawstack.com/docs/api-reference) for full details on each endpoint and its response shape.

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance65

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/31663512?v=4)[Pushpak Chhajed](/maintainers/pushpak1300)[@pushpak1300](https://github.com/pushpak1300)

---

Top Contributors

[![pushpak1300](https://avatars.githubusercontent.com/u/31663512?v=4)](https://github.com/pushpak1300 "pushpak1300 (1 commits)")

---

Tags

ailaravellaravel-aitool

### Embed Badge

![Health badge](/badges/shipfastlabs-toolkit-jigsawstack/health.svg)

```
[![Health](https://phpackages.com/badges/shipfastlabs-toolkit-jigsawstack/health.svg)](https://phpackages.com/packages/shipfastlabs-toolkit-jigsawstack)
```

###  Alternatives

[ampproject/amp-toolbox

A collection of AMP tools making it easier to publish and host AMP pages with PHP.

73633.1k1](/packages/ampproject-amp-toolbox)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)