mytweets

tweet saya

Cari semua tweet Anda.

Fitur

• Izinkan mengimpor Arsip data arsip twitter Anda
  • Artinya, aplikasi ini mendukung pencarian seluruh riwayat twitter Anda
• Mendukung Twitter dan Bluesky
• Ambil tweet terbaru melalui Twitter API/BlueSky API dan gabungkan dengan riwayat Anda
  • Selain itu, ini dapat diotomatisasi oleh GitHub Actions
• Frontend Web untuk Tweet Anda!
  • Mendukung pencarian teks lengkap ke semua tweet Anda
  • S3 Pilih berdasarkan pencarian teks lengkap
  • Anda dapat membuat mesin pencari pribadi untuk Anda

Ringkasan

Penggunaan

1. Klik Gunakan templat ini dan repositori bercabang
   • Anda dapat memilih Publik atau Pribadi
2. git mengkloning repositori bercabang

git clone https://github.com/you/mytweets
cd mytweets

Aplikasi ini memerlukan token berikut:

• Token API Twitter
• Kunci Akses S3
• Bucket S3 untuk menyimpan tweets.json

Anda harus memasukkannya ke file .env .

cp .env.example .env

Twitter

1. Buat Klien API Twitter V2
2. Dapatkan kunci API, Rahasia Kunci API, Token Akses, Rahasia Token Akses
3. Masukkan ini ke file .env

 S3_AWS_ACCESS_KEY_ID="x"
S3_AWS_SECRET_ACCESS_KEY="x"
S3_AWS_REGION="us-east-1"
S3_BUCKET_NAME="x"
TWITTER_APP_KEY="YOUR_TWITTER_API_KEY"
TWITTER_APP_SECRET="YOUR_TWITTER_API_KEY_SECRET"
TWITTER_ACCESS_TOKEN="YOUR_TWITTER_ACCESS_TOKEN"
TWITTER_ACCESS_SECRET="YOUR_TWITTER_ACCESS_TOKEN_SECRET"

S3

1. Buat bucket S3 untuk menyimpan tweet Anda.
2. Buat kunci API di AWS IAM
   • Kunci API ini memerlukan izin GET,PUT,List untuk S3

Contoh kebijakan Izin:

YOUR_S3_BUCKET_NAME adalah nama keranjang pada Langkah 1

{
  "Version" : " 2012-10-17 " ,
  "Statement" : [
    {
      "Sid" : " mytweets " ,
      "Effect" : " Allow " ,
      "Action" : " s3:* " ,
      "Resource" : " arn:aws:s3:::{your-mytweets-bucket-name}/* "
    }
  ]
}

3. Masukkan token API dan nama bucket S3 ke file .env

S3_AWS_ACCESS_KEY_ID= " x "
S3_AWS_SECRET_ACCESS_KEY= " x "
S3_AWS_REGION= " us-east-1 "
S3_BUCKET_NAME= " x "
TWITTER_APP_KEY= " YOUR_TWITTER_API_KEY "
TWITTER_APP_SECRET= " YOUR_TWITTER_API_KEY_SECRET "
TWITTER_ACCESS_TOKEN= " YOUR_TWITTER_ACCESS_TOKEN "
TWITTER_ACCESS_SECRET= " YOUR_TWITTER_ACCESS_TOKEN_SECRET " 

langit biru

Jika Anda ingin mendapatkan postingan Bluesky, Anda dapat menggunakan yarn run fetch-bsky alih-alih yarn run fetch-tweets .

1. Tambahkan akun bluesky Anda ke .env .

 S3_AWS_ACCESS_KEY_ID = "x"
S3_AWS_SECRET_ACCESS_KEY = "x"
S3_AWS_REGION = "us-east-1"
S3_BUCKET_NAME = "x"
BLUESKY_IDENTIFIER = "xxx.bsky.social"
BLUESKY_APPPASSWORD = "x"

2. Gunakan yarn run fetch-bsky alih-alih yarn run fetch-tweets di [alur kerja perbarui](./.github/workflows/update.yml

Impor dari arsip Twitter

1. Minta arsip Twitter Anda
2. Unduh file arsip Twitter seperti twitter-*.zip
3. Salin tweeet*.js ke twitter-archives/

 twitter-archives/
├── tweet.js
├── tweet-part1.js
└── tweet-part2.js

4. Jalankan perintah impor:

 yarn install
yarn import-twitter-archives # Concvert twitter-archives
yarn fetch-tweets  # Fetch diffs via Twitter API
yarn upload-s3 # upload to S3

Ambil tweet terbaru dan gabungkan

Membutuhkan: TWITTER_* dan S3_* env dalam file .env

Ambil tweet terbaru dari akun Twitter Anda menggunakan Twitter API.

perintah yarn fetch-tweets ambil tweet dan gabungkan menjadi tweets.json . yarn upload-s3 unggah tweets.json ke bucket S3 Anda.

 yarn install
yarn download-s3 # download tweets.json from S3
yarn fetch-tweets  # Fetch diffs via Twitter API
yarn prefetch-bsky  # Fetch diffs via Bluesky API
yarn upload-s3 # upload to S3

Menyebarkan Situs Web

Anda dapat menerapkan frontend web ke Web Hosting seperti Vercel.

1. Buat akun Vercel
2. Buat proyek baru
3. Pilih "Impor Repositori Git"
4. Pilih repositori bercabang Anda
5. Setel web/ ke "Direktori Root"
6. Tetapkan nilai berikut ke "Variabel Lingkungan"
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_BUCKET_NAME
   • NEXT_PUBLIC_AUTH_KEY=<secure random string>
   • ️ Jika Anda ingin membatasi akses ke situs web Anda, Anda harus menyetel string acak aman ke NEXT_PUBLIC_AUTH_KEY
   • Jika Anda ingin mengizinkan akses publik ke situs web Anda, Anda harus menyetel "public" ke NEXT_PUBLIC_AUTH_KEY=public
7. Menyebarkan
8. Anda dapat mengakses situs web Anda seperti https://<yourmytweets>.vercel.app/?k=<NEXT_PUBLIC_AUTH_KEY> .

Kueri Penelusuran Default

https://<yourmytweets>.vercel.app/?k=<NEXT_PUBLIC_AUTH_KEY>&q=<search keyword>&max=<max search count>

Aplikasi web mendukung kueri url berikut:

• ?k=<Your Secret Key - same with NEXT_PUBLIC_AUTH_KEY>
• &q=<search keyword>
• &max=<max search count>
  • Bawaan: 20

Kiat

Pembaruan Jadwal

Anda dapat mengotomatiskan yarn fetch-tweets dan yarn upload-s3 menggunakan CI seperti GitHub Action.

Repositori templat ini mencakup .github/workflows/update.yml yang memperbarui tweets.json Anda setiap hari.

1. Kunjungi pengaturan repositori fork Anda https://github.com/owner/mytweets/settings/secrets/actions
2. Masukkan env berikut ke rahasia Action
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_AWS_REGION
   • S3_BUCKET_NAME
   • Jika Anda ingin mengambil tweet
     • TWITTER_APP_KEY
     • TWITTER_APP_SECRET
     • TWITTER_ACCESS_TOKEN
     • TWITTER_ACCESS_SECRET
   • Jika Anda ingin mengambil postingan Bluesky
     • BLUESKY_IDENTIFIER
     • BLUESKY_APPPASSWORD

Nilai ini sama dengan .env .

Terkait

• azu/delete-tweets: Twitterのアーカイブから削除候補のTweetsを抽出する補助ツールと削除するツール。

log perubahan

Lihat halaman Rilis.

Menjalankan tes

Instal devDependencies dan Jalankan npm test :

 npm test

Berkontribusi

Permintaan tarik dan bintang selalu diterima.

Untuk bug dan permintaan fitur, silakan buat masalah.

1. Garpu!
2. Buat cabang fitur Anda: git checkout -b my-new-feature
3. Komit perubahan Anda: git commit -am 'Add some feature'
4. Dorong ke cabang: git push origin my-new-feature
5. Kirim permintaan tarik :D

Pengarang

• azu: GitHub, Twitter, Bluesky

Lisensi

MIT © azu