XActions/scripts/joinCommunities.js at main · nirholas/XActions · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
// Copyright (c) 2024-2026 nich (@nichxbt). Licensed under the Apache License, Version 2.0.
// scripts/joinCommunities.js
// Browser console script for discovering and joining X communities by keyword
// Paste in DevTools console on x.com/i/communities/suggested
// by nichxbt

(() => {
  const sleep = (ms) => new Promise(r => setTimeout(r, ms));

  // =============================================
  // CONFIGURATION
  // =============================================
  const CONFIG = {
    keywords: [
      // 'javascript',
      // 'web3',
    ],
    maxJoins: 5,
    dryRun: true,               // SET FALSE TO EXECUTE
    delay: 3000,
    scrollDelay: 2000,
    maxScrollRetries: 10,
  };
  // =============================================

  let joined = 0;
  const processed = new Set();

  const run = async () => {
    console.log('🏘️ JOIN COMMUNITIES — XActions by nichxbt\n');

    if (CONFIG.dryRun) console.log('⚠️ DRY RUN — Set CONFIG.dryRun = false to actually join\n');
    if (CONFIG.keywords.length > 0) console.log(`🔍 Keywords: ${CONFIG.keywords.join(', ')}\n`);

    let retries = 0;

    while (joined < CONFIG.maxJoins && retries < CONFIG.maxScrollRetries) {
      const cards = document.querySelectorAll('div[data-testid="communityCard"], a[href^="/i/communities/"]');
      let foundNew = false;

      for (const card of cards) {
        if (joined >= CONFIG.maxJoins) break;

        const linkEl = card.tagName === 'A' ? card : card.querySelector('a[href^="/i/communities/"]');
        const communityId = linkEl?.href?.match(/communities\/(\d+)/)?.[1] || '';
        if (!communityId || processed.has(communityId)) continue;
        processed.add(communityId);
        foundNew = true;

        const name = card.textContent?.trim()?.substring(0, 80) || 'Unknown';

        // Filter by keywords
        if (CONFIG.keywords.length > 0) {
          const nameLC = name.toLowerCase();
          if (!CONFIG.keywords.some(kw => nameLC.includes(kw.toLowerCase()))) continue;
        }

        if (CONFIG.dryRun) {
          console.log(`   🏘️ Would join: ${name}`);
          joined++;
          continue;
        }

        try {
          const joinBtn = card.querySelector('button[data-testid="join"]') || card.querySelector('button');
          if (joinBtn && joinBtn.textContent.toLowerCase().includes('join')) {
            joinBtn.click();
            await sleep(CONFIG.delay);
            console.log(`   ✅ Joined: ${name}`);
            joined++;
          } else if (linkEl) {
            // Navigate to community page to find join button
            linkEl.click();
            await sleep(2000);
            const joinOnPage = document.querySelector('button[data-testid="join"]');
            if (joinOnPage) {
              joinOnPage.click();
              console.log(`   ✅ Joined: ${name}`);
              joined++;
              await sleep(1000);
            }
            window.history.back();
            await sleep(1500);
          }
        } catch (e) {
          console.warn(`   ⚠️ Failed to join: ${name}`);
        }
      }

      if (!foundNew) retries++;
      else retries = 0;

      window.scrollTo(0, document.body.scrollHeight);
      await sleep(CONFIG.scrollDelay);
    }

    console.log(`\n✅ ${CONFIG.dryRun ? 'Would join' : 'Joined'} ${joined} communities`);
    console.log('🏁 Done!');
  };

  run();
})();