YASS عبارة عن مجال فرعي للبحث يعمل بملابس إضافية. هدفها هو إعطائك أداة للاستعلام عن محرك البحث الذي تحبه وتحليل استجابة HTML أقل من 10 أسطر من التعليمات البرمجية .
usage: yass [-g] [-d] [-l {debug,info,warning,error,critical}] [-c | -nc] [-h]
[-u] [-v]
DOMAIN [SUBDOMAIN [SUBDOMAIN ...]]
positional arguments:
DOMAIN the domain to search for
SUBDOMAIN the list of subdomains to exclude
Output arguments:
-g, --grepable output results in grepable format (default: False)
-d, --debug set output format to a more verbose one, for debugging
purpose (default: False)
-l {debug,info,warning,error,critical}, --level {debug,info,warning,error,critical}
set output verbosity (default: info)
-c, --color use color in the output (default: True)
-nc, --no-color do not use color in the output
Informations:
-h, --help show this help and exit
-u, --usage show the usage and exit
-v, --version show the framework version an exit
$ yass microsoft.com
________________________________________________
YASS - Yet Another Subdomainer Software (v0.11.7)
by Francesco Marano (@mrnfrancesco)
________________________________________________
[INFO ] Collecting subdomains with Aol
[INFO ] (1/1) www.catalog.update.microsoft.com
[INFO ] (2/2) partner.microsoft.com
[INFO ] (3/3) docs.microsoft.com
[INFO ] (4/4) account.microsoft.com
[...]
[INFO ] (64/64) techcommunity.microsoft.com
[INFO ] Collecting subdomains with Ask
[INFO ] (1/65) imaginecup.microsoft.com
[INFO ] (2/66) office.microsoft.com
[INFO ] (3/67) customers.microsoft.com
[INFO ] (4/68) privacy.microsoft.com
[INFO ] (5/69) grv.microsoft.com
[INFO ] (6/70) channel9.microsoft.com
[INFO ] (7/71) datamigration.microsoft.com
[INFO ] (8/72) edusupport.microsoft.com
[INFO ] (9/73) forms.microsoft.com
[INFO ] (10/74) visualstudiogallery.msdn.microsoft.com
[INFO ] Collecting subdomains with Bing
[INFO ] Collecting subdomains with StartPage
[INFO ] Collecting subdomains with WebCrawler
[INFO ] Collecting subdomains with Yahoo
Collected 74 subdomains
academy.microsoft.com, account.microsoft.com, admin.manage.microsoft.com, admin.powerplatform.microsoft.com, answers.microsoft.com, apportal.microsoft.com, appsource.microsoft.com, azure.microsoft.com, bingads.microsoft.com, businessaccount.microsoft.com, businesscenter.mbs.microsoft.com, careers.microsoft.com, channel9.microsoft.com, client.dtmnebula.microsoft.com, cmat.tools.cp.microsoft.com, cmt3.research.microsoft.com, customers.microsoft.com, datamigration.microsoft.com, demos.microsoft.com, devblogs.microsoft.com, developer.microsoft.com, docs.microsoft.com, dotnet.microsoft.com, dynamics.microsoft.com, education.microsoft.com, edusupport.microsoft.com, einvoice.microsoft.com, events.microsoft.com, expertzone.microsoft.com, findtime.microsoft.com, flow.microsoft.com, forms.microsoft.com, formspro.microsoft.com, gallery.technet.microsoft.com, grv.microsoft.com, home.microsoft.com, imaginecup.microsoft.com, mail.exchange.microsoft.com, mbs.microsoft.com, mbspartner.microsoft.com, military.microsoft.com, mla.microsoft.com, mvp.microsoft.com, myinspire.microsoft.com, myprofile.microsoft.com, news.microsoft.com, nonprofit.microsoft.com, office.microsoft.com, partner.microsoft.com, partneruniversity.microsoft.com, paymentcentral.microsoft.com, plmt.microsoft.com, powerapps.microsoft.com, powerbi.microsoft.com, privacy.microsoft.com, referencesource.microsoft.com, register.ignite.microsoft.com, secure.bingads.microsoft.com, servicedesk.microsoft.com, serviceshub.microsoft.com, social.technet.microsoft.com, support.microsoft.com, teams.microsoft.com, techcommunity.microsoft.com, testconnectivity.microsoft.com, todo.microsoft.com, update.microsoft.com, visualstudio.microsoft.com, visualstudiogallery.msdn.microsoft.com, whiteboard.microsoft.com, windowsupdate.microsoft.com, www.catalog.update.microsoft.com, www.commerce.microsoft.com, www.microsoft.com يمكن أيضًا استخدام Yass في البرامج النصية مع خيار -g/--grepable :
$ yass -g microsoft.com
academy.microsoft.com|account.microsoft.com|admin.manage.microsoft.com|admin.powerplatform.microsoft.com|answers.microsoft.com|apportal.microsoft.com|appsource.microsoft.com|azure.microsoft.com|bingads.microsoft.com|businessaccount.microsoft.com|businesscenter.mbs.microsoft.com|careers.microsoft.com|channel9.microsoft.com|client.dtmnebula.microsoft.com|cmat.tools.cp.microsoft.com|cmt3.research.microsoft.com|customers.microsoft.com|datamigration.microsoft.com|demos.microsoft.com|devblogs.microsoft.com|developer.microsoft.com|docs.microsoft.com|dotnet.microsoft.com|dynamics.microsoft.com|education.microsoft.com|edusupport.microsoft.com|einvoice.microsoft.com|events.microsoft.com|expertzone.microsoft.com|findtime.microsoft.com|flow.microsoft.com|formspro.microsoft.com|gallery.technet.microsoft.com|grv.microsoft.com|home.microsoft.com|imaginecup.microsoft.com|mail.exchange.microsoft.com|mbs.microsoft.com|mbspartner.microsoft.com|military.microsoft.com|mla.microsoft.com|mvp.microsoft.com|myinspire.microsoft.com|myorder.microsoft.com|myprofile.microsoft.com|news.microsoft.com|nonprofit.microsoft.com|office.microsoft.com|partner.microsoft.com|partneruniversity.microsoft.com|paymentcentral.microsoft.com|plmt.microsoft.com|powerapps.microsoft.com|powerbi.microsoft.com|privacy.microsoft.com|referencesource.microsoft.com|register.ignite.microsoft.com|secure.bingads.microsoft.com|servicedesk.microsoft.com|serviceshub.microsoft.com|social.technet.microsoft.com|support.microsoft.com|teams.microsoft.com|techcommunity.microsoft.com|testconnectivity.microsoft.com|todo.microsoft.com|update.microsoft.com|visualstudio.microsoft.com|visualstudiogallery.msdn.microsoft.com|whiteboard.microsoft.com|windowsupdate.microsoft.com|www.catalog.update.microsoft.com|www.commerce.microsoft.com|www.microsoft.comيأتي Yass مع بعض الإضافات التي تم بناؤها مسبقًا:
يمكنك إلقاء نظرة عليها في yass/plugins.py .
يتبع الإضافات YASS بعض القواعد فقط:
يتم تخزين جميع الإضافات في وحدة yass/plugins.py .
يجب على كل مكون إضافي yass.models.PluginBase من الفئة الفرعية وتحديد فئة داخلية تسمى Meta مع السمات التالية في ذلك:
search_url [إلزامي] ، سلسلة تمثل عنوان URL الأساسي لمحرك البحثquery_param [افتراضي: 'q' ] ، المعلمة المستخدمة لتخزين الاستعلامinclude_param [افتراضي: 'site%3A' ] ، المعلمة التي يجب استخدامها في محرك البحث للبحث عن مجال معينexclude_param [افتراضي: '-site%3A' ] ، المعلمة التي يجب استخدامها في محرك البحث لاستبعاد مجال معين من النتائجsubdomains_selector [إلزامي] ، محدد jQuery (نعم ، jQuery) حيث يمكن العثور على النطاقات الفرعية من صفحة النتائجrequest_delay [الافتراضي: .250 ] ، عدد الثواني للانتظار بعد كل استعلام قبل الاستعلام مرة أخرىيمكنك استخدام سلوك البرنامج المساعد الافتراضي في معظم الحالات ، ولكن إذا كنت بحاجة إلى تغييره ، فيمكنك تجاوز هذه الطرق فقط:
url(self, exclude_subdomain=None) ، فإنه يوفر سلسلة الاستعلام بناءً على سمات Metaextract(self, elements) ، يستخرج سلسلة عنوان URL من قائمة Element الكائنات (انظر إلى PyQuery لمعرفة كيفية عملها)clean(self, urls) ، يزيل أجزاء عديمة الفائدة من قائمة عناوين URL للحصول على سلسلة النطاق الفرعي فقط ياس متوافق تمامًا مع Python 3.7 ولديه متطلبات فقط:
لتثبيت ياس ومتطلباته:
$ git clone https://github.com/mrnfrancesco/yass.git # or download and unzip release archive
$ cd yass
$ ./setup.py installأو يمكنك استخدام Docker:
# Download YASS' Dockerfile
$ wget " https://raw.githubusercontent.com/mrnfrancesco/yass/master/Dockerfile "
# Build the latest version of YASS (use YASS_VERSION arg to build specific version)
$ docker build -t mrnfrancesco/yass:latest .
$ docker run --rm -ti mrnfrancesco/yass:latest /bin/sh
/yass # yass --version
YASS v0.11.7