Download the PHP package plin-code/laravel-instagram-digest without Composer

laravel-instagram-digest

Scrape Instagram hashtags via Apify, filter profiles by keywords and follower threshold, and send a daily Telegram digest with inline action buttons. Classify candidates with one tap.

What it does

1. Runs the Apify apify~instagram-scraper actor against a list of hashtags.
2. Filters results by bio/username keyword match and a minimum follower count.
3. Upserts surviving profiles into instagram_digest_profiles.
4. Once a day, sends the next N pending profiles as Telegram cards with inline buttons: Interesting, Reject, Show again later. Custom actions pluggable.
5. Handles the callback when you tap a button: updates the profile status and removes the buttons from the message.

Bring your own data sources (hashtags, keywords, min-followers, chat id) via closures or plain config. Extend with custom action buttons and a custom card renderer.

Installation

Add to your .env:

Quickstart

In AppServiceProvider@boot:

Register the Telegram webhook:

Verify your Telegram setup end-to-end:

The demo uses a placehold.co URL for the placeholder image, so Telegram must be able to fetch that URL. If your network or bot configuration blocks external image fetches, pass a photo URL explicitly:

(Note: the --to option overrides the configured chat_id but currently uses the same placeholder image. For a full dry-run with your own image, register a custom CardRenderer — see below.)

Data sources: resolvers vs config

Every data source has two equivalent ways to supply it.

Via config (config/instagram-digest.php or env):

Via resolver closure (takes precedence when registered):

If no resolver is registered, the package falls back to config.

Custom actions

Register your own inline button:

Replace the default action set entirely:

Any class implementing PlinCode\InstagramDigest\Contracts\DigestAction is accepted.

Custom card rendering

Option A: publish the Blade view and edit it

Then edit resources/views/vendor/instagram-digest/card.blade.php.

Option B: register your own renderer

Your renderer must return a PlinCode\InstagramDigest\Support\CardPayload.

Customizing the webhook route

The webhook is registered by the package at POST /instagram-digest/webhook/{secret?} with the api middleware group. Both the URL prefix and the middleware stack are config-driven — edit config/instagram-digest.php after publishing:

Then adjust:

If you need full control (different HTTP verb, route model binding, custom controller), you can bypass the auto-registered route by setting 'middleware' => ['api', 'should-never-match'] (breaks the route) and defining your own pointing at PlinCode\InstagramDigest\Http\Controllers\WebhookController.

Scheduling

The package does NOT register any scheduled tasks. Wire the commands yourself in routes/console.php:

Events

Listen to the following events to integrate with your own domain:

Example listener:

Testing your integration

The package plays nicely with Laravel's HTTP fakes and event fakes. In your own tests:

For the Telegram side, fake api.telegram.org/* and assert via Http::assertSent(...).

Commands

Testing

License

MIT. See LICENSE.md.