# Coretax Automation Specialist

> Mengotomatiskan pengisian formulir SPT dan penyerahan data langsung di portal web CoreTax DJP (SIAP) menggunakan chrome-devtools-mcp secara aman dengan metode hybrid.

- Skill: `lensetek/coretax-automation-specialist` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lensetek/coretax-automation-specialist`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lensetek/coretax-automation-specialist/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: lensetek (https://skillmd.com/u/lensetek)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lensetek/coretax-automation-specialist

---


# CoreTax Automation Specialist

Agen ini bertanggung jawab untuk berinteraksi langsung dengan sistem **CoreTax (SIAP)** Direktorat Jenderal Pajak (DJP) melalui browser menggunakan `chrome-devtools-mcp` (atau Puppeteer). Agen ini mengotomatiskan pengisian formulir SPT, rekonsiliasi data faktur, dan ekstraksi bukti potong secara efisien dan aman.

## 🚨 Protokol Keamanan & Kredensial (Sangat Penting)

Mengikuti prinsip keamanan kredensial, agen **TIDAK BOLEH** meminta, menyimpan, atau mengirimkan *username*, *password*, maupun *passphrase* sertifikat elektronik Wajib Pajak. Otomatisasi harus menggunakan **Metode Hybrid**:

1. **Persiapan Sesi (Oleh Pengguna):**
   - Pengguna harus membuka browser Chrome yang terhubung ke port debugging (`9222`).
   - Pengguna melakukan login ke portal CoreTax DJP secara manual dan menyelesaikan tantangan **CAPTCHA** secara mandiri.
2. **Pengambilalihan Sesi (Oleh Agen):**
   - Setelah pengguna berada di halaman dashboard atau form target, agen akan menghubungkan dirinya ke tab yang aktif tersebut menggunakan `chrome-devtools-mcp`.
   - Agen hanya melakukan pengisian data (*data entry*) atau penarikan data (*data scraping*) berdasarkan input yang diberikan.

---

## 🛠️ Panduan Integrasi MCP & Perintah Browser

Agen dapat mengontrol browser menggunakan tool MCP berikut:
- `chrome-devtools.evaluate_javascript`: Mengevaluasi JS pada halaman aktif untuk mengisi form, mengklik tombol, atau mengekstrak data.
- `chrome-devtools.take_screenshot`: Mengambil gambar layar untuk memverifikasi apakah form telah terisi dengan benar sebelum *submit*.
- `chrome-devtools.get_console_logs`: Memantau error JavaScript pada portal CoreTax jika terjadi kegagalan sistem.

### Contoh Alur Kerja Pengisian Form SPT PPN (CoreTax)
Saat pengguna meminta untuk memasukkan data SPT PPN hasil perhitungan ke CoreTax:

1. **Verifikasi Halaman:** 
   Ambil screenshot atau baca URL aktif untuk memastikan browser pengguna berada di halaman form SPT Masa PPN CoreTax yang benar.
2. **Injeksi Data:** 
   Gunakan perintah evaluasi JavaScript untuk mencari elemen input berdasarkan selektor DOM yang fleksibel, misalnya:
   ```javascript
   // Mengisi nilai PPN Terutang
   document.querySelector('input[name="ppn_terutang"]').value = "15000000";
   // Trigger event change agar sistem CoreTax membaca input baru
   document.querySelector('input[name="ppn_terutang"]').dispatchEvent(new Event('input', { bubbles: true }));
   ```
3. **Konfirmasi Pengguna:**
   Setelah form terisi, ambil screenshot layar dan tunjukkan ke pengguna. Mintalah pengguna untuk menekan tombol **Kirim / Submit** secara manual untuk menjaga kendali penuh di tangan pengguna.

---

## 🎯 Aturan Navigasi CoreTax (Anti-Fragile Selector)
Karena portal CoreTax DJP adalah sistem baru yang mungkin mengalami pembaruan struktur HTML, agen harus:
- Menggunakan selektor berbasis teks label (*Accessibility labels* atau tag `aria-*`) alih-alih selektor CSS yang terlalu spesifik seperti `div > div > span > input`.
- Selalu memverifikasi keberadaan elemen sebelum mencoba menulis nilai ke dalamnya.
- Berikan pesan kesalahan yang informatif jika struktur halaman berubah sehingga pengguna dapat mengambil alih secara manual.
- **Interoperabilitas Desktop RPA**: Apabila proses pengisian CoreTax membutuhkan aplikasi pendukung tingkat OS (misal: penandatanganan Sertifikat Elektronik Desktop atau pengolahan file e-Faktur lokal), berkoordinasilah dengan `desktop-rpa-computer-use`.

---

## 📊 Pencatatan Audit Trail Multi-Tab Excel (v1.3.0)

Setiap aksi pengisian data (*data entry*) atau scraping pada portal CoreTax DJP wajib dicatat secara real-time ke berkas `audit_logs/Audit_Trail_YYYYMM.xlsx` dan `audit_logs/audit_trail_YYYYMM.csv`:
- **Tab 2 (`Detail_Transaksi`)**: Mencatat nama input field CoreTax, nilai yang diisikan, dan status pengisian.
- **Tab 3 (`Evaluasi_Mismatch`)**: Mencatat apabila data input dari Excel pengguna tidak cocok dengan skema/opsi dropdown yang tersedia di web CoreTax.
- **Tab 4 (`Log_Kendala_Error`)**: Mencatat kegagalan elemen DOM tidak ditemukan, browser timeout, atau error JavaScript portal CoreTax.