mytweets

ทวีตของฉัน

ค้นหาทวีตทั้งหมดของคุณ

คุณสมบัติ

• อนุญาตให้นำเข้าข้อมูลที่เก็บถาวรของข้อมูลเก็บถาวร Twitter ของคุณ
  • หมายความว่าแอพนี้รองรับการค้นหาประวัติ Twitter ทั้งหมดของคุณ
• รองรับทวิตเตอร์และบลูสกาย
• รับทวีตล่าสุดผ่าน Twitter API/BlueSky API และรวมเข้ากับประวัติของคุณ
  • นอกจากนี้ยังสามารถดำเนินการอัตโนมัติโดย GitHub Actions
• ส่วนหน้าของเว็บสำหรับทวีตของคุณ!
  • รองรับการค้นหาข้อความแบบเต็มในทวีตทั้งหมดของคุณ
  • S3 เลือกการค้นหาข้อความแบบเต็มตาม
  • คุณสามารถสร้างเครื่องมือค้นหาส่วนตัวให้กับคุณได้

ภาพรวม

การใช้งาน

1. คลิกใช้เทมเพลตนี้และพื้นที่เก็บข้อมูลแบบแยกส่วน
   • คุณสามารถเลือกสาธารณะหรือส่วนตัว
2. git โคลนพื้นที่เก็บข้อมูลแบบแยกส่วน

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

แอปพลิเคชันนี้ต้องการโทเค็นต่อไปนี้:

• โทเค็น Twitter API
• คีย์การเข้าถึง S3
• ที่เก็บข้อมูล S3 สำหรับการบันทึก tweets.json

คุณต้องใส่สิ่งเหล่านี้ลงในไฟล์ . .env

cp .env.example .env

ทวิตเตอร์

1. สร้างไคลเอนต์ Twitter V2 API
2. รับคีย์ API, ข้อมูลลับของคีย์ API, โทเค็นการเข้าถึง, ข้อมูลลับโทเค็นการเข้าถึง
3. ใส่สิ่งเหล่านี้ลงในไฟล์ .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. สร้างบัคเก็ต S3 เพื่อบันทึกทวีตของคุณ
2. สร้างคีย์ API บน AWS IAM
   • คีย์ API นี้ต้องการสิทธิ์ GET, PUT, List สำหรับ S3

ตัวอย่างนโยบายการอนุญาต:

YOUR_S3_BUCKET_NAME คือชื่อที่เก็บข้อมูลของขั้นตอนที่ 1

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

3. ใส่โทเค็น API และชื่อบัคเก็ต S3 ลงในไฟล์ .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 " 

บลูสกาย

หากคุณต้องการรับโพสต์ของ Bluesky คุณสามารถใช้ yarn run fetch-bsky แทน yarn run fetch-tweets

1. เพิ่มบัญชี bluesky ของคุณไปที่ .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. ใช้ yarn run fetch-bsky แทน yarn run fetch-tweets ใน [อัพเดตเวิร์กโฟลว์](./.github/workflows/update.yml

นำเข้าจากไฟล์เก็บถาวร Twitter

1. ขอเก็บถาวร Twitter ของคุณ
2. ดาวน์โหลดไฟล์เก็บถาวร Twitter เช่น twitter-*.zip
3. คัดลอก tweeet*.js ไปที่ twitter-archives/

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

4. รันคำสั่งนำเข้า:

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

ดึงทวีตล่าสุดและรวมเข้าด้วยกัน

ต้องการ: TWITTER_* และ S3_* env ในไฟล์ .env

ดึงข้อมูลทวีตล่าสุดจากบัญชี Twitter ของคุณโดยใช้ Twitter API

คำสั่ง yarn fetch-tweets ดึงทวีตและรวมเข้ากับ tweets.json yarn upload-s3 อัปโหลด tweets.json ไปยังที่ฝากข้อมูล S3 ของคุณ

 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

ปรับใช้เว็บไซต์

คุณสามารถปรับใช้ส่วนหน้าของเว็บกับเว็บโฮสติ้งเช่น Vercel

1. สร้างบัญชี Vercel
2. สร้างโครงการใหม่
3. เลือก "นำเข้าที่เก็บ Git"
4. เลือกพื้นที่เก็บข้อมูลแบบแยกของคุณ
5. ตั้งค่า web/ เป็น "Root Directory"
6. ตั้งค่าต่อไปนี้เป็น "ตัวแปรสภาพแวดล้อม"
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_BUCKET_NAME
   • NEXT_PUBLIC_AUTH_KEY=<secure random string>
   • หากคุณต้องการจำกัดการเข้าถึงเว็บไซต์ของคุณ คุณควรตั้งค่าสตริงสุ่มที่ปลอดภัยเป็น NEXT_PUBLIC_AUTH_KEY
   • หากคุณต้องการอนุญาตให้สาธารณะเข้าถึงเว็บไซต์ของคุณ คุณควรตั้งค่า "public" เป็น NEXT_PUBLIC_AUTH_KEY=public
7. ปรับใช้
8. คุณสามารถเข้าถึงเว็บไซต์ของคุณได้ เช่น https://<yourmytweets>.vercel.app/?k=<NEXT_PUBLIC_AUTH_KEY>

คำค้นหาเริ่มต้น

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

เว็บแอปรองรับการสืบค้น URL ต่อไปนี้:

• ?k=<Your Secret Key - same with NEXT_PUBLIC_AUTH_KEY>
• &q=<search keyword>
• &max=<max search count>
  • ค่าเริ่มต้น: 20

เคล็ดลับ

กำหนดการอัพเดต

คุณสามารถทำให้ yarn fetch-tweets และ yarn upload-s3 เป็นอัตโนมัติโดยใช้ CI เช่น GitHub Action

พื้นที่เก็บข้อมูลเทมเพลตนี้ประกอบด้วย .github/workflows/update.yml ที่อัปเดต tweets.json ของคุณทุกวัน

1. เยี่ยมชมการตั้งค่าที่เก็บส้อมของคุณ https://github.com/owner/mytweets/settings/secrets/actions
2. ใส่ env ต่อไปนี้ลงในความลับของ Action
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_AWS_REGION
   • S3_BUCKET_NAME
   • หากคุณต้องการดึงทวีต
     • TWITTER_APP_KEY
     • TWITTER_APP_SECRET
     • TWITTER_ACCESS_TOKEN
     • TWITTER_ACCESS_SECRET
   • หากคุณต้องการดึงโพสต์ Bluesky
     • BLUESKY_IDENTIFIER
     • BLUESKY_APPPASSWORD

ค่าเหล่านี้เหมือนกับ . .env

ที่เกี่ยวข้อง

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

บันทึกการเปลี่ยนแปลง

ดูหน้าการเผยแพร่

กำลังดำเนินการทดสอบ

ติดตั้ง devDependencies และรัน npm test :

 npm test

มีส่วนร่วม

ยินดีต้อนรับคำขอดึงและดาวเสมอ

สำหรับข้อบกพร่องและการร้องขอคุณสมบัติ โปรดสร้างปัญหา

1. ส้อมมัน!
2. สร้างสาขาฟีเจอร์ของคุณ: git checkout -b my-new-feature
3. ยอมรับการเปลี่ยนแปลงของคุณ: git commit -am 'Add some feature'
4. พุชไปที่สาขา: git push origin my-new-feature
5. ส่งคำขอดึง :D

ผู้เขียน

• azu: GitHub, Twitter, Bluesky

ใบอนุญาต

MIT © azu