Tinyfish: Web Agent untuk AI Developer, Ini Cara Kerjanya

Script Playwright atau Selenium sering rusak ketika tampilan situs berubah. Mengelola proxy dan browser juga menambah pekerjaan. Tinyfish adalah platform infrastruktur web untuk AI agent yang menyatukan pencarian, pengambilan konten, cloud browser, dan otomasi web dalam satu API. Berikut cara kerja, fitur, manfaat, keamanan, hingga cara memulainya.

Apa Itu Tinyfish?

Tinyfish adalah platform yang membantu AI agent membaca dan berinteraksi dengan situs web tanpa developer harus membangun seluruh infrastruktur browser sendiri.

Berbeda dari search API yang hanya mencari informasi atau scraper tradisional yang bergantung pada struktur halaman, Tinyfish menyediakan beberapa komponen web dalam satu ekosistem. 

Kamu bisa mencari informasi, mengambil konten, mengendalikan browser, hingga menjalankan tugas multi-langkah menggunakan instruksi bahasa biasa.

Baca Juga: Rahasia Menjalankan AI Agent di HP via Termius, Simak!

Karena Tinyfish disebut sebagai web agent, wajar kalau muncul pertanyaan berikut: “apa bedanya web agent, browser agent, dan browser extension?”

• Web agent: AI yang memahami tujuan dan menyelesaikan tugas di web.
• Browser agent: agent yang mengoperasikan browser untuk melakukan navigasi dan interaksi.
• Browser extension: ekstensi yang menambahkan fungsi pada browser, tetapi tidak selalu memiliki kemampuan penalaran dan otomasi mandiri.

Jadi, web agent tidak sekadar menjalankan perintah klik, tetapi berusaha menyelesaikan tujuan yang diberikan. Kemampuan inilah yang membuat Tinyfish berbeda dari sekadar alat otomasi biasa, dan di bagian berikutnya kita bahas bagaimana cara kerjanya.

Baca Juga: Apa Itu Context Window? Ini Alasannya Penting buat AI Agent

Cara Kerja Tinyfish sebagai Web Agent

Untuk memahami cara kerja Tinyfish, bayangkan kamu ingin membuat agent yang memantau harga produk di beberapa marketplace. Agent harus membuka situs, membaca informasi, menemukan harga, lalu mengirimkan hasilnya ke aplikasi.

Proses ini melibatkan tiga lapisan utama.

1. Perception, Reasoning, dan Action

Web agent bekerja melalui tiga tahapan:

PERCEPTION
Membaca halaman dan elemen web
        ↓
REASONING
LLM memahami tujuan dan menentukan langkah
        ↓
ACTION
Klik, ketik, navigasi, dan ekstraksi
        ↓
HASIL
Data terstruktur dalam JSON

Pada tahap perception, agent membaca kondisi halaman. Informasi tersebut digunakan oleh LLM untuk menentukan tindakan berikutnya melalui reasoning.

Selanjutnya, action menjalankan instruksi, seperti membuka menu, mengisi formulir, login, atau mengambil data.

Pendekatan ini membuat otomasi browser berbasis AI lebih fleksibel dibandingkan script yang hanya mengandalkan selector CSS atau XPath.

2. Alur Satu Run Tinyfish

Developer cukup mengirimkan dua input: URL dan goal dalam bahasa biasa.

Contohnya:

• URL: https://example.com/products
• Goal: “Ambil nama dan harga produk yang tampil. Jangan melakukan pembelian.”

Tinyfish kemudian menjalankan agent melalui cloud browser dan mengembalikan hasil yang dapat diproses sebagai JSON.

Selama proses berlangsung, kamu bisa memantau event berikut:

1. STARTED: agent mulai bekerja.
2. STREAMING_URL: URL live preview tersedia.
3. PROGRESS: perkembangan tugas dikirimkan.
4. COMPLETE: proses run berakhir.

Live preview membantu developer memeriksa aktivitas agent ketika terjadi kendala atau hasilnya tidak sesuai harapan.

3. Mengenal Endpoint Tinyfish

Tinyfish menyediakan tiga pola eksekusi:

Pilih endpoint berdasarkan kebutuhan workflow. Untuk debugging, /run-sse lebih praktis karena perkembangan agent bisa dipantau secara langsung.

Apa Saja yang Bisa Dilakukan Tinyfish?

Tinyfish memiliki beberapa produk yang bisa digunakan secara terpisah maupun dikombinasikan.

Tinyfish juga mendukung MCP untuk Claude dan Cursor, integrasi ChatGPT dan Claude, node n8n, serta SDK Python dan TypeScript.

Dengan dukungan tersebut, kamu bisa mengintegrasikan Tinyfish ke dalam web stack untuk AI agent tanpa harus membangun seluruh komponen dari awal.

Kenapa Developer Perlu Tinyfish?

Keunggulan utama Tinyfish adalah menyederhanakan infrastruktur web AI agent. Developer tidak perlu mengelola sendiri seluruh kebutuhan browser, proxy, dan sesi untuk setiap workflow.

Beberapa manfaat lainnya meliputi:

• Mengurangi ketergantungan pada selector: agent memahami konteks halaman, bukan hanya mengandalkan selector yang rentan berubah.
• Satu API key: akses beberapa produk melalui satu ekosistem dan Wallet.
• Eksekusi paralel: mendukung pekerjaan multi-task sesuai batas penggunaan akun.
• Hemat token LLM: TinyFetch membersihkan elemen halaman yang tidak relevan sebelum konten diproses.
• Integrasi fleksibel: tersedia SDK dan konektor untuk berbagai workflow developer.

Meski begitu, Tinyfish bukan solusi untuk semua kebutuhan scraping.

Jika situs menyediakan API resmi atau halamannya statis, Scrapy dan httpx biasanya lebih ekonomis. Tinyfish lebih relevan ketika kamu membutuhkan interaksi web dinamis dan otomasi multi-langkah.

Contoh Penggunaan Tinyfish

Ada beberapa skenario yang bisa dikembangkan menggunakan Tinyfish:

• Monitoring kompetitor: memeriksa harga dan perubahan produk secara berkala.
• Enrichment CRM: mencari informasi perusahaan untuk melengkapi data prospek.
• Riset multi-situs: mengumpulkan informasi dari berbagai sumber.
• Otomasi supplier: login ke portal, memeriksa stok, dan mengambil status pesanan.

Menurut studi kasus yang dipublikasikan Tinyfish, platform ini membantu sebuah marketplace kebugaran memperluas cakupan studio dari sekitar 2.000 menjadi lebih dari 8.000 venue. Angka tersebut merupakan klaim studi kasus Tinyfish, bukan jaminan hasil implementasi serupa.

Contoh Implementasi dengan Python

Berikut ilustrasi pemanggilan API menggunakan Python:

import os
import requests

response = requests.post(
    "https://agent.tinyfish.ai/run-sse",
    headers={
        "X-API-Key": os.environ["TINYFISH_API_KEY"],
        "Content-Type": "application/json"
    },
    json={
        "url": "https://example.com/products",
        "goal": "Ambil nama dan harga produk. Jangan melakukan pembelian."
    },
    stream=True,
    timeout=120
)

for line in response.iter_lines():
    if line:
        print(line.decode("utf-8"))

Sesuaikan header autentikasi dan struktur payload dengan dokumentasi API terbaru sebelum digunakan di production.

Perhatikan juga instruksi yang diberikan. Goal “ambil data produk” terlalu umum. Lebih baik gunakan instruksi seperti “ambil lima produk pertama, sertakan nama dan harga, gunakan null jika harga tidak tersedia, dan jangan mengirim formulir”.

Jika belum ingin coding, kamu juga bisa mencoba Tinyfish melalui integrasi ChatGPT atau Claude.

Apakah Tinyfish Aman?

Keamanan web agent perlu diperhatikan, terutama ketika agent diberi akses ke akun atau portal bisnis.

Tinyfish menyediakan TinyVault yang dapat dihubungkan dengan 1Password atau Bitwarden. Berdasarkan dokumentasinya, kredensial yang dipilih diberikan untuk kebutuhan run tanpa harus ditampilkan kepada model LLM.

Ada juga TinyProfiles untuk menyimpan sesi login agar agent tidak perlu melakukan autentikasi ulang setiap kali menjalankan tugas.

Dari sisi transparansi, fitur run recordings memungkinkan developer meninjau kembali aktivitas agent untuk kebutuhan audit dan debugging.

Meski demikian, ada beberapa praktik yang tetap perlu diterapkan:

• Simpan API key dalam environment variable.
• Berikan akses hanya pada akun yang berwenang.
• Tambahkan guardrail seperti “jangan checkout” atau “jangan submit”.
• Minta persetujuan sebelum agent melakukan tindakan penting.
• Validasi hasil sebelum diteruskan ke database.
• Patuhi Terms of Service situs target dan hukum yang berlaku.

Untuk informasi sertifikasi dan kontrol keamanan, kamu bisa mengunjungi Trust Center Tinyfish.

Harga dan Cara Memulai Tinyfish

Tinyfish menggunakan sistem pembayaran berdasarkan pemakaian. Berikut tarif yang dipublikasikan:

Akun baru mendapatkan saldo awal $8. Kuota dan harga dapat berubah, jadi periksa halaman resmi sebelum mulai menggunakannya.

Untuk mencoba Tinyfish melalui API, ikuti langkah berikut:

1. Daftar melalui agent.tinyfish.ai.
2. Buat API key melalui menu API Keys.
3. Simpan key sebagai environment variable TINYFISH_API_KEY.
4. Jalankan agent pertama dengan memasukkan URL dan goal.
5. Pantau event dan validasi hasilnya.

Kamu juga bisa memulai tanpa kode melalui integrasi ChatGPT atau Claude dengan menyelesaikan proses autentikasi terlebih dahulu.

Kesimpulan

Tinyfish menawarkan cara praktis untuk membangun AI agent yang mampu membaca dan berinteraksi dengan web. Dengan TinySearch, TinyFetch, TinyBrowser, dan TinyAgent, developer bisa mengembangkan otomasi web tanpa harus mengelola seluruh infrastruktur browser sendiri.

Namun, workflow AI agent tetap membutuhkan server yang stabil untuk menjalankan aplikasi, background process, monitoring, dan pengolahan data secara berkelanjutan.

Untuk kebutuhan tersebut, VPS Murah dari IDwebhost bisa menjadi pilihan infrastruktur pendukung. Tinyfish membutuhkan server yang dapat berjalan terus dan dikonfigurasi sesuai kebutuhan workflow. VPS memberikan kontrol resource dan konfigurasi yang lebih leluasa dibandingkan shared hosting.

Jadi, jika kamu sedang membangun AI agent untuk kebutuhan bisnis atau proyek otomatisasi, VPS IDwebhost bisa menjadi fondasi yang tepat untuk mengembangkan aplikasi dan workflow secara lebih fleksibel.